DdeSetQualityOfService 関数 (dde.h)

[アーティクル]
02/26/2024

開始する今後の DDE 会話に対して生の動的データ交換 (DDE) アプリケーションが望むサービス品質 (QOS) を指定します。指定された 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 メッセージ交換を開始するためにクライアントが送信するメッセージのソースWM_DDE_INITIATE指定する DDE クライアントウィンドウへのハンドル。

[in] pqosNew

型: const SECURITY_QUALITY_OF_SERVICE*

目的のサービス品質値の SECURITY_QUALITY_OF_SERVICE 構造体へのポインター。

[out] pqosPrev

種類: PSECURITY_QUALITY_OF_SERVICE

hwndClient によって識別されるウィンドウに関連付けられた以前のサービス品質値を受け取るSECURITY_QUALITY_OF_SERVICE構造体へのポインター。

このパラメーターは省略可能です。 アプリケーションが hwndClient の以前の QOS 値に関心がない場合は、pqosPrev を NULL に設定する必要があります。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

wParam が hwndClient に設定されたWM_DDE_INITIATEを送信する前に、クライアントウィンドウ hwndClient にサービス品質が指定されていない場合、システムはクライアントウィンドウに次の既定のサービス品質値を使用します。

{ 
   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 を含む)
Library	User32.lib
[DLL]	User32.dll