PWLX_WIN31_MIGRATE callback function (winwlx.h)

[The WlxWin31Migrate function is no longer available for use as of Windows Server 2008 and Windows Vista.]

Called by a replacement GINA DLL if Terminal Services is enabled.

GINA calls this function to complete the setup of the Terminal Services client.

Note   GINA DLLs are ignored in Windows Vista.
 

Syntax

PWLX_WIN31_MIGRATE PwlxWin31Migrate;

void PwlxWin31Migrate(
  [in] HANDLE hWlx
)
{...}

Parameters

[in] hWlx

Specify the handle received in the call to WlxInitialize.

Return value

None

Remarks

GINA needs to call this function before starting the shell, so that the migration and setup will be complete before the shell starts, but after it has processed any logon scripts.

In order to use this function, the GINA DLL must specify the WLX_DISPATCH_VERSION_1_3 structure in its call to WlxInitialize, and set the Winlogon version to at least WLX_VERSION_1_3 in its WlxNegotiate call.

Other Winlogon support functions that may be called when Terminal Services is enabled are WlxDisconnect, WlxQueryClientCredentials, and WlxQueryInetConnectorCredentials.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header winwlx.h

See also

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryClientCredentials

WlxQueryInetConnectorCredentials