DdeSetQualityOfService 函式 (dde.h)

發行項
02/29/2024

指定原始動態數據交換 (DDE) 應用程式未來起始的 DDE 交談所需的服務品質 (QO) S。指定的 QOS 適用於在設定就緒時啟動的任何交談。 DDE 交談的服務質量會持續進行交談;在交談期間呼叫 DdeSetQualityOfService 函 式不會影響該交談的 QOS。

語法

BOOL DdeSetQualityOfService(
  [in]  HWND                              hwndClient,
  [in]  const SECURITY_QUALITY_OF_SERVICE *pqosNew,
  [out] PSECURITY_QUALITY_OF_SERVICE      pqosPrev
);

參數

[in] hwndClient

類型： HWND

DDE 用戶端視窗的句柄，指定用戶端將傳送以啟動 DDE 交談的訊息來源WM_DDE_INITIATE 訊息。

[in] pqosNew

類型： const SECURITY_QUALITY_OF_SERVICE*

所需服務品質值的 SECURITY_QUALITY_OF_SERVICE 結構的指標。

[out] pqosPrev

類型： PSECURITY_QUALITY_OF_SERVICE

SECURITY_QUALITY_OF_SERVICE 結構的指標，可接收與 hwndClient 所識別之視窗相關聯的先前服務品質值。

這是選擇性參數。如果應用程式對 hwndClient 先前的 QOS 值沒有興趣，它應該將 pqosPrev 設定為 NULL。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果在傳送 wParam 設為 hwndClient 的WM_DDE_INITIATE之前，尚未為客戶端視窗指定服務品質，則系統會針對客戶端視窗使用下列預設服務品質值：

{ 
   Length = sizeof(SECURITY_QUALITY_OF_SERVICE); 
   ImpersonationLevel = SecurityImpersonation; 
   ContextTrackingMode = SECURITY_STATIC_TRACKING; 
   EffectiveOnly = TRUE; 
}

使用 DdeSetQualityOfService 函式，將不同的服務品質與客戶端視窗產生關聯。變更服務質量之後，新的設定會影響任何後續啟動的對話。一旦應用程式使用特定服務品質值啟動 DDE 交談，它就必須終止交談並重新啟動交談，才能讓不同的值生效。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	dde.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll