Edit

Share via

SEC_WINNT_CREDUI_CONTEXT structure (sspi.h)

  • Article

Specifies unserialized credential information. The credential information can be serialized by passing it as the rgbSerialization member of a CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION structure in a call to the ICredentialProvider::SetSerialization method.

The unserialized information can be obtained by calling the SspiUnmarshalCredUIContext function.

Syntax

typedef struct _SEC_WINNT_CREDUI_CONTEXT {
  USHORT                          cbHeaderLength;
  HANDLE                          CredUIContextHandle;
#if ...
  PCREDUI_INFOW                   UIInfo;
#else
  PVOID                           UIInfo;
#endif
  ULONG                           dwAuthError;
  PSEC_WINNT_AUTH_IDENTITY_OPAQUE pInputAuthIdentity;
  PUNICODE_STRING                 TargetName;
} SEC_WINNT_CREDUI_CONTEXT, *PSEC_WINNT_CREDUI_CONTEXT;

Members

cbHeaderLength

The size, in bytes, of the header.

CredUIContextHandle

A handle to the credential context.

UIInfo

A pointer to a CREDUI_INFO structure that specifies information for the credential prompt dialog box.

dwAuthError

Specifies why prompting for credentials is needed. A caller can pass this Windows error parameter, returned by another authentication call, to allow the dialog box to accommodate certain errors. For example, if the password expired status code is passed, the dialog box prompts the user to change the password on the account.

pInputAuthIdentity

The opaque authentication identity data.

TargetName

The name of the target.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header sspi.h