Fonction DdeSetQualityOfService (dde.h)

Article
08/23/2023

Spécifie la qualité de service (QOS) qu’une application DDE (Dynamic Data Exchange) brute souhaite pour les conversations DDE futures qu’elle lance. Le QOS spécifié s’applique à toutes les conversations démarrées lorsque ces paramètres sont en place. La qualité de service d’une conversation DDE dure pendant toute la durée de la conversation ; Les appels à la fonction DdeSetQualityOfService au cours d’une conversation n’affectent pas la qoS de cette conversation.

Syntaxe

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

Paramètres

[in] hwndClient

Type : HWND

Handle de la fenêtre du client DDE qui spécifie la source de WM_DDE_INITIATE messages qu’un client enverra pour démarrer les conversations DDE.

[in] pqosNew

Type : const SECURITY_QUALITY_OF_SERVICE*

Pointeur vers une structure de SECURITY_QUALITY_OF_SERVICE pour les valeurs de qualité de service souhaitées.

[out] pqosPrev

Type : PSECURITY_QUALITY_OF_SERVICE

Pointeur vers une structure de SECURITY_QUALITY_OF_SERVICE qui reçoit les valeurs de qualité de service précédentes associées à la fenêtre identifiée par hwndClient.

Ce paramètre est facultatif. Si une application n’a aucun intérêt pour les valeurs QOS précédentes de hwndClient, elle doit définir pqosPrev sur NULL.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si aucune qualité de service n’a été spécifiée pour une fenêtre cliente, hwndClient, avant l’envoi d’un WM_DDE_INITIATE avec le paramètre wParam défini sur hwndClient, le système utilise les valeurs de qualité de service par défaut suivantes pour la fenêtre cliente :

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

Utilisez la fonction DdeSetQualityOfService pour associer une autre qualité de service à la fenêtre cliente. Une fois que vous avez modifié la qualité de service, les nouveaux paramètres affectent toutes les conversations suivantes qui sont démarrées. Une fois qu’une application démarre une conversation DDE à l’aide d’une valeur de qualité de service particulière, elle doit mettre fin à la conversation et la redémarrer pour qu’une autre valeur prenne effet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dde.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll