Função DdeSetQualityOfService (dde.h)

Artigo
08/23/2023

Especifica a qualidade do serviço (QOS) que um aplicativo DDE (Dynamic Data Exchange) bruto deseja para futuras conversas de DDE iniciadas. O QOS especificado se aplica a todas as conversas iniciadas enquanto essas configurações estão em vigor. A qualidade de serviço de uma conversa DDE dura durante a conversa; as chamadas para a função DdeSetQualityOfService durante uma conversa não afetam o QOS dessa conversa.

Sintaxe

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

Parâmetros

[in] hwndClient

Digite: HWND

Um identificador para a janela do cliente DDE que especifica a origem de WM_DDE_INITIATE mensagens que um cliente enviará para iniciar conversas DDE.

[in] pqosNew

Tipo: const SECURITY_QUALITY_OF_SERVICE*

Um ponteiro para uma estrutura SECURITY_QUALITY_OF_SERVICE para a qualidade desejada dos valores de serviço.

[out] pqosPrev

Tipo: PSECURITY_QUALITY_OF_SERVICE

Um ponteiro para uma estrutura de SECURITY_QUALITY_OF_SERVICE que recebe a qualidade anterior dos valores de serviço associados à janela identificada por hwndClient.

Esse parâmetro é opcional. Se um aplicativo não tiver interesse nos valores de QOS anteriores do hwndClient, ele deverá definir pqosPrev como NULL.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se uma qualidade de serviço não tiver sido especificada para uma janela do cliente, hwndClient, antes de enviar um WM_DDE_INITIATE com o wParam definido como hwndClient, o sistema usará a seguinte qualidade padrão de valores de serviço para a janela do cliente:

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

Use a função DdeSetQualityOfService para associar uma qualidade de serviço diferente à janela do cliente. Depois de alterar a qualidade do serviço, as novas configurações afetam as conversas subsequentes iniciadas. Depois que um aplicativo inicia uma conversa DDE usando uma qualidade específica de valor de serviço, ele deve encerrar a conversa e reiniciar a conversa para que um valor diferente entre em vigor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dde.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll