This topic has not yet been rated - Rate this topic

WlxShutdown function

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

Applies to: desktop apps only

The WlxShutdown function must be implemented by a replacement GINA DLL. Winlogon calls this function just before shutting down, allowing the GINA to perform any shutdown tasks, such as ejecting a smart card from a reader.

Note   GINA DLLs are ignored in Windows Vista.

Syntax

void WlxShutdown(
  __in  PVOID pWlxContext,
  __in  DWORD ShutdownType
);

Parameters

pWlxContext [in]

A pointer to the GINA context associated with this window station. The GINA returns this context value when Winlogon calls WlxInitialize for this station.

ShutdownType [in]

Specifies the type of shutdown. This parameter can be one of the following values.

ValueMeaning
WLX_SAS_ACTION_SHUTDOWN
5 (0x5)

Logs the user off and shuts down the computer.

WLX_SAS_ACTION_SHUTDOWN_REBOOT
11 (0xB)

Shuts down and restarts the computer.

WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
10 (0xA)

Shuts down and turns off the computer, if the hardware allows.

 

Return value

This function does not return a value.

Remarks

Winlogon calls WlxShutdown after the user has logged off and the WlxLogoff function has been called.

Before calling WlxShutdown, Winlogon sets the desktop state so that the current desktop is the Winlogon desktop and sets the workstation state so that the desktop is locked.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Winwlx.h

See also

WlxInitialize
WlxLogoff

 

 

Send comments about this topic to Microsoft

Build date: 3/13/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ