Funzione DdeSetQualityOfService (dde.h)

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

Vedi anche

Informazioni su Dynamic Data Exchange

Informazioni concettuali

Altre risorse

Riferimento

SECURITY_QUALITY_OF_SERVICE

WM_DDE_INITIATE