DdeSetQualityOfService 函数 (dde.h)

项目
02/29/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 客户端窗口的句柄，指定客户端将发送用于启动 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。

注解

如果尚未为客户端窗口 hwndClient 指定服务质量，在发送 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)
Library	User32.lib
DLL	User32.dll