This topic has not yet been rated - Rate this topic

SpUpdateCredentialsFn function

Applies to: desktop apps only

Updates the credentials associated with the specified context.

Syntax

NTSTATUS NTAPI SpUpdateCredentialsFn(
  __in  LSA_SEC_HANDLE ContextHandle,
  __in  GUID *CredType,
  __in  ULONG FlatCredUIContextLength,
  PUCHAR FlatCredUIContext
);

Parameters

ContextHandle [in]

A handle to the context to update.

CredType [in]

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

ValueMeaning
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).

 

FlatCredUIContextLength [in]

The size, in characters, of the buffer specified by the FlatCredUIContext parameter.

FlatCredUIContext

A string that specifies the updated credentials.

Return value

If the function succeeds, return STATUS_SUCCESS, or an informational status code.

If the function fails, return an NTSTATUS error code that indicates the reason it failed. For more information, see Remarks.

Remarks

A pointer to the SpUpdateCredentialsFn function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.

Requirements

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Ntsecpkg.h

 

 

Send comments about this topic to Microsoft

Build date: 3/13/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ