PassportWizardRunDll function

[This function is available through Windows XP with Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.]

Launches the Passport Wizard when used with Rundll32.exe.

Syntax

void PassportWizardRunDll(
  _In_ HWND      hwndStub,
  _In_ HINSTANCE hAppInstance,
  _In_ LPTSTR    lpszCmdLine,
  _In_ int       nCmdShow
);

Parameters

hwndStub [in]

Type: HWND

A handle to an owner window. This parameter is typically set to NULL.

hAppInstance [in]

Type: HINSTANCE

A handle to the library file, obtained as a return value from LoadLibrary("netplwiz").

lpszCmdLine [in]

Type: LPTSTR

Argument data. This value will always be empty.

nCmdShow [in]

Type: int

Sets the display mode for the window.

Return value

None.

Remarks

The Passport Wizard is used to obtain a default Passport for Windows. A Passport gives the user personalized access to all MSN websites and other Passport-enabled sites using the user's email address. Using PassportWizardRunDll as an entry point into the Netplwiz.dll file through a Rundll32 command allows you to launch the Passport Wizard from a command line as though it were an executable file.

PassportWizardRunDll is used solely in the context of a Rundll32.exe command as follows:

rundll32.exe netplwiz.dll, PassportWizardRunDll

Using an entry point function with Rundll32.exe does not resemble a normal function call. The function name and the name of the .dll file where it is stored are used only as command-line parameters. The function definition shown under Syntax is only a standard prototype for all functions that you can call using Rundll32. The specific values for hwndStub, hAppInstance, and nCmdShow are not provided by the user, but are handled behind the scenes by Rundll32. PassportWizardRunDll does not use the lpszCmdLine value, so no additional data is required.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	None
DLL	Netplwiz.dll (version 5.60 or later)