ImpersonateDdeClientWindow function

Enables a Dynamic Data Exchange (DDE) server application to impersonate a DDE client application's security context. This protects secure server data from unauthorized DDE clients.

Syntax


BOOL WINAPI ImpersonateDdeClientWindow(
  _In_  HWND hWndClient,
  _In_  HWND hWndServer
);

Parameters

hWndClient [in]

Type: HWND

A handle to the DDE client window to be impersonated. The client window must have established a DDE conversation with the server window identified by the hWndServer parameter.

hWndServer [in]

Type: HWND

A handle to the DDE server window. An application must create the server window before calling this function.

Return value

Type: BOOL

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.

Security Considerations

Using this function incorrectly might compromise the security of your program. It is very important to check the return value of the call. If the function fails for any reason, the client is not impersonated and any subsequent client request is made in the security context of the calling process. If the calling process is running as a highly privileged account, such as LocalSystem or as a member of an administrative group, the user may be able to perform actions that would otherwise be disallowed. Therefore, if the call fails or raises an error do not continue execution of the client request.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Dde.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
DdeImpersonateClient
Conceptual
About Dynamic Data Exchange
Other Resources
RevertToSelf

 

 

Community Additions

ADD
Show:
© 2014 Microsoft