ImpersonateDdeClientWindow

The ImpersonateDdeClientWindow function enables a DDE server application to impersonate a DDE client application's security context. This protects secure server data from unauthorized DDE clients.

BOOL ImpersonateDdeClientWindow(
  HWND hWndClient,  // handle to DDE client window
  HWND hWndServer   // handle to DDE server window
);

Parameters

hWndClient

[in] Handle to the DDE client window to impersonate. The client window must have established a DDE conversation with the server window identified by the hWndServer parameter.

hWndServer

[in] Handle to the DDE server window. An application must create the server window before calling this function.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application should call the RevertToSelf function to undo the impersonation set by the ImpersonateDdeClientWindow function.

A DDEML application should use the DdeImpersonateClient function.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Dde.h; include Windows.h.
  Library: Use User32.lib.

See Also

Dynamic Data Exchange Overview, Dynamic Data Exchange Functions, DdeImpersonateClient, RevertToSelf