DdeImpersonateClient-Funktion (ddeml.h)

Artikel
02/29/2024

Gibt eine DDE-Clientanwendung (Dynamic Data Exchange) in einer DDE-Clientunterhaltung an.

Syntax

BOOL DdeImpersonateClient(
  [in] HCONV hConv
);

Parameter

[in] hConv

Typ: HCONV

Ein Handle für die DDE-Clientunterhaltung, die identitätswechselt werden soll.

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

Identitätswechsel ist die Fähigkeit eines Prozesses, die Sicherheitsattribute eines anderen Prozesses zu übernehmen. Wenn ein Client in einer DDE-Unterhaltung Informationen von einem DDE-Server anfordert, gibt der Server die Identität des Clients an. Wenn der Server Zugriff auf ein Objekt anfordert, überprüft das System den Zugriff anhand der Sicherheitsattribute des Clients.

Wenn der Identitätswechsel abgeschlossen ist, ruft der Server normalerweise die RevertToSelf-Funktion auf.

Sicherheitsüberlegungen

Wenn der Aufruf von DdeImpersonateClient aus irgendeinem Grund fehlschlägt, wird der Client nicht identitätswechselt, und die Clientanforderung wird im Sicherheitskontext des aufrufenden Prozesses gestellt. Wenn der aufrufende Prozess als Konto mit hohem Privilegierten ausgeführt wird, z. B. LocalSystem, oder als Mitglied einer administrativen Gruppe, kann der Benutzer möglicherweise Aktionen ausführen, die andernfalls nicht zulässig wären. Aus diesem Grund ist es wichtig, dass Sie immer den Rückgabewert des Aufrufs überprüfen. Wenn ein Fehler nicht ausgelöst werden kann, setzen Sie die Ausführung der Clientanforderung nicht fort.

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	ddeml.h (Einschließen von Windows.h)
Bibliothek	User32.lib
DLL	User32.dll