Edit

Share via

SspiUpdateCredentials function (sspi.h)

  • Article

Updates the credentials associated with the specified context.

Syntax

SECURITY_STATUS SEC_ENTRY SspiUpdateCredentials(
  [in] HANDLE ContextHandle,
  [in] GUID   *CredType,
  [in] ULONG  FlatCredUIContextLength,
  [in] PUCHAR FlatCredUIContext
);

Parameters

[in] ContextHandle

A pointer to a SEC_WINNT_CREDUI_CONTEXT structure retrieved during a previous call to the SspiUnmarshalCredUIContext function.

[in] CredType

The type of credential specified by the ContextHandle parameter. This can be one of the following values.

Value Meaning
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD
0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a
 The credential is a password.
SEC_WINNT_AUTH_DATA_TYPE_CERT
0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b
 The credential is a certificate.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA
0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0
 The credential is authentication data from a cryptographic service provider (CSP).

[in] FlatCredUIContextLength

The size, in bytes, of the FlatCredUIContext buffer.

[in] FlatCredUIContext

The values with which to update the specified credentials.

Return value

If the function succeeds, it returns SEC_E_OK.

If the function fails, it returns a nonzero error code.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header sspi.h
Library Credui.lib
DLL Credui.dll