PWLX_SET_CONTEXT_POINTER callback function (winwlx.h)

Article
02/22/2024

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

Called by GINA to specify the context pointer passed by Winlogon as the first parameter to all future calls to GINA functions.

Note GINA DLLs are ignored in Windows Vista.

This allows GINA to specify a new context pointer that replaces the one returned by the WlxInitialize function.

This function has been superseded by the WlxSetOption function called with the Option parameter set to WLX_OPTION_CONTEXT_POINTER.

Syntax

PWLX_SET_CONTEXT_POINTER PwlxSetContextPointer;

void PwlxSetContextPointer(
  [in] HANDLE hWlx,
  [in] PVOID pWlxContext
)
{...}

Parameters

[in] hWlx

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

[in] pWlxContext

Pointer to the new context that Winlogon will use in future calls to GINA.

Return value

None

Remarks

If the GINA must call WlxSasNotify from the WlxInitialize function, it should first call WlxSetContextPointer to let Winlogon associate a context with the GINA.

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