Función DdeSetQualityOfService (dde.h)

Artículo
02/29/2024

Especifica la calidad del servicio (QOS) que desea una aplicación de Intercambio de datos dinámicos (DDE) sin procesar para futuras conversaciones de DDE que inicia. La QOS especificada se aplica a las conversaciones iniciadas mientras están en vigor esas configuraciones. La calidad del servicio de una conversación DDE dura durante la conversación; Las llamadas a la función DdeSetQualityOfService durante una conversación no afectan a la QOS de esa conversación.

Sintaxis

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

Parámetros

[in] hwndClient

Tipo: HWND

Identificador de la ventana del cliente DDE que especifica el origen de WM_DDE_INITIATE mensajes que un cliente enviará para iniciar conversaciones de DDE.

[in] pqosNew

Tipo: const SECURITY_QUALITY_OF_SERVICE*

Puntero a una estructura de SECURITY_QUALITY_OF_SERVICE para la calidad deseada de los valores de servicio.

[out] pqosPrev

Tipo: PSECURITY_QUALITY_OF_SERVICE

Puntero a una estructura de SECURITY_QUALITY_OF_SERVICE que recibe la calidad anterior de los valores de servicio asociados a la ventana identificada por hwndClient.

Este parámetro es opcional. Si una aplicación no tiene ningún interés en los valores de QOS anteriores de hwndClient, debe establecer pqosPrev en NULL.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si no se ha especificado una calidad de servicio para una ventana de cliente, hwndClient, antes de enviar un WM_DDE_INITIATE con wParam establecido en hwndClient, el sistema usa la siguiente calidad de servicio predeterminada para la ventana del cliente:

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

Use la función DdeSetQualityOfService para asociar una calidad de servicio diferente a la ventana del cliente. Después de cambiar la calidad del servicio, la nueva configuración afecta a las conversaciones posteriores que se inician. Una vez que una aplicación inicia una conversación DDE mediante un valor de calidad de servicio determinado, debe finalizar la conversación y reiniciar la conversación para que un valor diferente surta efecto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dde.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll