WlxSetOption function
[The WlxSetOption function is no longer available for use as of Windows Server 2008 and Windows Vista.]
Called by GINA to set the value of an option.
Syntax
BOOL WlxSetOption( _In_ HANDLE hWlx, _In_ DWORD Option, _In_ ULONG_PTR Value, _Out_ ULONG_PTR *OldValue );
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
- Value [in]
-
Specifies a new value for the option.
- OldValue [out]
-
On return, pointer to the old value the option was set to.
Return value
The WlxSetOption function returns one of the following values.
| Return code | Description |
|---|---|
|
The option was set to the value specified in the Value parameter. |
|
Winlogon did not set Option to 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.
Use WlxGetOption to retrieve the current value of an option.
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 |
|
See also