Export (0) Print
Expand All
Expand Minimize

WlxGetOption function

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

Called by GINA to retrieve the current value of an option.

Note   GINA DLLs are ignored in Windows Vista.

Syntax


BOOL WlxGetOption(
  _In_   HANDLE hWlx,
  _In_   DWORD Option,
  _Out_  ULONG_PTR *Value
);

Parameters

hWlx [in]

Specifies the Winlogon handle passed to GINA in the WlxInitialize call.

Option [in]

Specifies one of the following options:

WLX_OPTION_USE_CTRL_ALT_DEL
WLX_OPTION_CONTEXT_POINTER
WLX_OPTION_USE_SMART_CARD
WLX_OPTION_SMART_CARD_PRESENT
WLX_OPTION_SMART_CARD_INFO
WLX_OPTION_DISPATCH_TABLE_SIZE
Value [out]

Returns the current value of the option.

Return value

The WlxGetOption function returns one of the following values.

Return codeDescription
TRUE

The value of the option was returned in the Value parameter.

FALSE

Winlogon did not return the value.

 

Remarks

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Winwlx.h

See also

WlxInitialize
WLX_DISPATCH_VERSION_1_3
WlxNegotiate
WlxSetOption

 

 

Community Additions

ADD
Show:
© 2014 Microsoft