PWLX_SET_OPTION callback function (winwlx.h)
[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
PWLX_SET_OPTION PwlxSetOption;
BOOL PwlxSetOption(
[in] HANDLE hWlx,
[in] DWORD Option,
[in] ULONG_PTR Value,
[out] ULONG_PTR *OldValue
)
{...}
Parameters
[in] hWlx
Specifies the Winlogon handle passed to GINA in the WlxInitialize call.
[in] Option
Specifies one of the following options:
[in] Value
Specifies a new value for the option.
[out] OldValue
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
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 |