Share via


ImpersonateDdeClientWindow-Funktion (dde.h)

Ermöglicht einer DDE-Serveranwendung (Dynamic Data Exchange), die Identität des Sicherheitskontexts einer DDE-Clientanwendung anzugeben. Dadurch werden sichere Serverdaten vor nicht autorisierten DDE-Clients geschützt.

Syntax

BOOL ImpersonateDdeClientWindow(
  [in] HWND hWndClient,
  [in] HWND hWndServer
);

Parameter

[in] hWndClient

Typ: HWND

Ein Handle für das DDE-Clientfenster, das identitätswechseln soll. Das Clientfenster muss eine DDE-Konversation mit dem Serverfenster eingerichtet haben, das durch den hWndServer-Parameter identifiziert wird.

[in] hWndServer

Typ: HWND

Ein Handle für das DDE-Serverfenster. Eine Anwendung muss das Serverfenster erstellen, bevor diese Funktion aufgerufen wird.

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

Eine Anwendung sollte die RevertToSelf-Funktion aufrufen, um den von der Funktion ImpersonateDdeClientWindow festgelegten Identitätswechsel rückgängig zu machen.

Eine DDEML-Anwendung sollte die DdeImpersonateClient-Funktion verwenden.

Sicherheitsüberlegungen

Wenn Sie diese Funktion falsch verwenden, kann die Sicherheit Ihres Programms beeinträchtigt werden. Es ist sehr wichtig, den Rückgabewert des Aufrufs zu überprüfen. Wenn die Funktion aus irgendeinem Grund fehlschlägt, wird der Client nicht imItiert, und jede nachfolgende Clientanforderung wird im Sicherheitskontext des aufrufenden Prozesses gestellt. Wenn der aufrufende Prozess als Konto mit hohen Berechtigungen 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. Wenn der Aufruf fehlschlägt oder einen Fehler auslöst, wird daher die Ausführung der Clientanforderung nicht fortgesetzt.

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

Weitere Informationen

Informationen zum dynamischen Datenaustausch

Konzept

DdeImpersonateClient

Andere Ressourcen

Referenz

Reverttoself