共用方式為


DdeSetQualityOfService 函式 (dde.h)

指定原始動態數據交換 (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 設為 hwndClientWM_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

另請參閱

關於動態數據交換

概念

其他資源

參考

SECURITY_QUALITY_OF_SERVICE

WM_DDE_INITIATE