Windows Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

UpdateCredentials function

Provides a mechanism for one security package to notify other packages that the credentials for a logon session have changed.

Syntax


NTSTATUS UpdateCredentials(
  _In_     PSECPKG_PRIMARY_CRED            PrimaryCredentials,
  _In_opt_ PSECPKG_SUPPLEMENTAL_CRED_ARRAY Credentials
);

Parameters

PrimaryCredentials [in]

Pointer to a SECPKG_PRIMARY_CRED structure containing the primary credentials.

Credentials [in, optional]

Optional. Pointer to a SECPKG_SUPPLEMENTAL_CRED_ARRAY structure containing the supplemental credentials.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code indicating the reason it failed.

Remarks

To notify packages about the changed credentials, the Local Security Authority (LSA) calls the SpAcceptCredentials function implementation in each package.

A pointer to the UpdateCredentials function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

LSA_SECPKG_FUNCTION_TABLE
SECPKG_PRIMARY_CRED
SECPKG_SUPPLEMENTAL_CRED_ARRAY
SpAcceptCredentials
SpInitialize

 

 

Community Additions

ADD
Show:
© 2015 Microsoft