Funzione DdeSetQualityOfService (dde.h)

Articolo
02/29/2024

Specifica la qualità del servizio (QOS) di un'applicazione DDE (Dynamic Data Exchange) non elaborata per le future conversazioni DDE avviate. Il QOS specificato si applica a tutte le conversazioni avviate mentre tali impostazioni sono presenti. La qualità del servizio di una conversazione DDE dura per la durata della conversazione; le chiamate alla funzione DdeSetQualityOfService durante una conversazione non influiscono sul QOS della conversazione.

Sintassi

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

Parametri

[in] hwndClient

Tipo: HWND

Handle per la finestra del client DDE che specifica l'origine dei messaggi WM_DDE_INITIATE che un client invierà per avviare conversazioni DDE.

[in] pqosNew

Tipo: const SECURITY_QUALITY_OF_SERVICE*

Puntatore a una struttura SECURITY_QUALITY_OF_SERVICE per la qualità desiderata dei valori del servizio.

[out] pqosPrev

Tipo: PSECURITY_QUALITY_OF_SERVICE

Puntatore a una struttura SECURITY_QUALITY_OF_SERVICE che riceve la qualità precedente dei valori del servizio associati alla finestra identificata da hwndClient.

Questo parametro è facoltativo e, Se un'applicazione non ha alcun interesse per i valori QOS precedenti di hwndClient, deve impostare pqosPrev su NULL.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se non è stata specificata una qualità del servizio per una finestra client, hwndClient, prima di inviare un WM_DDE_INITIATE con wParam impostato su hwndClient, il sistema usa la qualità predefinita seguente dei valori di servizio per la finestra client:

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

Usare la funzione DdeSetQualityOfService per associare una qualità del servizio diversa alla finestra client. Dopo aver modificato la qualità del servizio, le nuove impostazioni influiscono sulle conversazioni successive avviate. Quando un'applicazione avvia una conversazione DDE usando un determinato valore di qualità del servizio, deve terminare la conversazione e riavviare la conversazione per rendere effettiva una conversazione diversa.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dde.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll