WLX_CLIENT_CREDENTIALS_INFO_V1_0 structure (winwlx.h)

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

The WLX_CLIENT_CREDENTIALS_INFO_V1_0 structure contains the client credentials returned by a call to WlxQueryClientCredentials or WlxQueryInetConnectorCredentials.

This allows a network client session to pass client credentials for automatic logon.

Note  WlxQueryClientCredentials is called when Terminal Services is enabled.

 

The GINA DLL is responsible for calling LocalFree to free the resources used by this structure when the structure is no longer needed.

Syntax

typedef struct _WLX_CLIENT_CREDENTIALS_INFO {
  DWORD dwType;
  PWSTR pszUserName;
  PWSTR pszDomain;
  PWSTR pszPassword;
  BOOL  fPromptForPassword;
} WLX_CLIENT_CREDENTIALS_INFO_V1_0, *PWLX_CLIENT_CREDENTIALS_INFO_V1_0;

Members

dwType

Specifies the type of credentials structure allocated by the GINA DLL. Credential types are defined with the prefix WLX_CREDENTIAL_TYPE_xxx.

pszUserName

A pointer to the name of the account logged onto.

pszDomain

A pointer to the name of the domain used to log on.

pszPassword

A pointer to the plaintext password of the user account. When you have finished using pszPassword, clear the sensitive information from memory by calling the SecureZeroMemory function.

Windows XP/2000:  SecureZeroMemory is not supported. Overwrite the memory allocated for pszPassword to clear the sensitive information.

For more information about protecting passwords, see Handling Passwords.

fPromptForPassword

Forces a prompt for the password due to an administration override. This allows the distinction of auto logon with no password.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	winwlx.h

See also

LocalFree

WlxQueryClientCredentials

WlxQueryInetConnectorCredentials