PWLX_QUERY_IC_CREDENTIALS callback function (winwlx.h)
[The WlxQueryInetConnectorCredentials function is no longer available for use as of Windows Server 2008 and Windows Vista.]
Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to determine whether the terminal server is using Internet connector licensing and to retrieve credentials information.
Syntax
PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;
BOOL PwlxQueryIcCredentials(
[out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}
Parameters
[out] pCred
When the return value is TRUE, pCred specifies a pointer to a WLX_CLIENT_CREDENTIALS_INFO_V1_0 structure that contains the credentials to use for auto logon.
Return value
The WlxQueryInetConnectorCredentials function returns one of the following values.
Return code | Description |
---|---|
|
Internet connector licensing is enabled. |
|
Internet connector licensing is not available. |
Remarks
The GINA DLL is responsible for calling LocalFree to free the resources used by this structure when the structure is no longer needed.
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.
If Terminal Services is not using an Internet connector license, the GINA DLL must call WlxQueryClientCredentials.
Other Winlogon support functions that may be called when Terminal Services is enabled are WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData and WlxWin31Migrate.
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 |