DdeSetQualityOfService-Funktion (dde.h)

Artikel
02/26/2024

Gibt die Dienstqualität (Quality of Service, QOS) an, die eine unformatierte DDE-Anwendung (Dynamic Data Exchange) für zukünftige DDE-Unterhaltungen wünscht, die sie initiiert. Das angegebene QOS gilt für alle Unterhaltungen, die gestartet werden, während diese Einstellungen vorhanden sind. Die Dienstqualität einer DDE-Unterhaltung dauert für die Dauer der Unterhaltung. Aufrufe der DdeSetQualityOfService-Funktion während einer Unterhaltung wirken sich nicht auf das QOS dieser Unterhaltung aus.

Syntax

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

Parameter

[in] hwndClient

Typ: HWND

Ein Handle für das DDE-Clientfenster, das die Quelle der WM_DDE_INITIATE Nachrichten angibt, die ein Client zum Starten von DDE-Unterhaltungen sendet.

[in] pqosNew

Typ: const SECURITY_QUALITY_OF_SERVICE*

Ein Zeiger auf eine SECURITY_QUALITY_OF_SERVICE-Struktur für die gewünschte Dienstqualität.

[out] pqosPrev

Typ: PSECURITY_QUALITY_OF_SERVICE

Ein Zeiger auf eine SECURITY_QUALITY_OF_SERVICE-Struktur , die die vorherigen Dienstqualitätswerte empfängt, die dem durch hwndClient identifizierten Fenster zugeordnet sind.

Dieser Parameter ist optional. Wenn eine Anwendung kein Interesse an den vorherigen QOS-Werten von hwndClient hat, sollte sie pqosPrev auf NULL festlegen.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn keine Dienstqualität für ein Clientfenster ( hwndClient) angegeben wurde, verwendet das System vor dem Senden eines WM_DDE_INITIATE , bei dem wParam auf hwndClient festgelegt ist, die folgenden Standardqualitätswerte für das Clientfenster:

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

Verwenden Sie die DdeSetQualityOfService-Funktion , um dem Clientfenster eine andere Dienstqualität zuzuordnen. Nachdem Sie die Dienstqualität geändert haben, wirken sich die neuen Einstellungen auf alle nachfolgenden Unterhaltungen aus, die gestartet werden. Sobald eine Anwendung eine DDE-Konversation mit einem bestimmten Dienstqualitätswert startet, muss sie die Konversation beenden und die Unterhaltung neu starten, damit ein anderer Wert wirksam wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dde.h (Windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll