SpAcceptCredentials function

Called by the Local Security Authority (LSA) to pass the security package any credentials stored for the authenticated security principal. This function is called once for each set of credentials stored by the LSA.

Syntax


NTSTATUS SpAcceptCredentials(
  _In_ SECURITY_LOGON_TYPE       LogonType,
  _In_ PUNICODE_STRING           AccountName,
  _In_ PSECPKG_PRIMARY_CRED      PrimaryCredentials,
  _In_ PSECPKG_SUPPLEMENTAL_CRED SupplementalCredentials
);

Parameters

LogonType [in]

A SECURITY_LOGON_TYPE value indicating the type of logon.

AccountName [in]

Pointer to a UNICODE_STRING structure specifying the name of the logged-on account.

PrimaryCredentials [in]

Pointer to a SECPKG_PRIMARY_CRED structure containing the credentials used to logon. This structure can have NULL members.

SupplementalCredentials [in]

Pointer to a SECPKG_SUPPLEMENTAL_CRED structure containing package-specific supplemental credentials.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Remarks

The security package should save the credentials so that it can service requests for credentials. For additional information, see the SpAcquireCredentialsHandle function.

SSP/APs must implement the SpAcceptCredentials function; unlike other SSP/AP functions the name of the function must be SpAcceptCredentials.

The LSA accesses the SpAcceptCredentials function through the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

SECPKG_PRIMARY_CRED
SECPKG_SUPPLEMENTAL_CRED
SECURITY_LOGON_TYPE
SpAcquireCredentialsHandle
SpLsaModeInitialize

 

 

Show: