SpAcceptCredentialsFn 콜백 함수(ntsecpkg.h)

아티클
03/05/2024

인증된 보안 주체에 대해 저장된 자격 증명을 보안 패키지에 전달하기 위해 LSA(로컬 보안 기관)에서 호출합니다. 이 함수는 LSA에 의해 저장된 각 자격 증명 집합에 대해 한 번 호출됩니다.

구문

SpAcceptCredentialsFn Spacceptcredentialsfn;

NTSTATUS Spacceptcredentialsfn(
  [in] SECURITY_LOGON_TYPE LogonType,
  [in] PUNICODE_STRING AccountName,
  [in] PSECPKG_PRIMARY_CRED PrimaryCredentials,
  [in] PSECPKG_SUPPLEMENTAL_CRED SupplementalCredentials
)
{...}

매개 변수

[in] LogonType

로그온 유형을 나타내는 SECURITY_LOGON_TYPE 값입니다.

[in] AccountName

로그온한 계정의 이름을 지정하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[in] PrimaryCredentials

로그온하는 데 사용되는 자격 증명을 포함하는 SECPKG_PRIMARY_CRED 구조체에 대한 포인터입니다. 이 구조체에는 NULL 멤버가 있을 수 있습니다.

[in] SupplementalCredentials

패키지별 추가 자격 증명을 포함하는 SECPKG_SUPPLEMENTAL_CRED 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 STATUS_SUCCESS 반환합니다.

함수가 실패하면 실패한 이유를 나타내는 NTSTATUS 코드를 반환합니다.

설명

보안 패키지는 자격 증명에 대한 요청을 서비스할 수 있도록 자격 증명을 저장해야 합니다. 자세한 내용은 SpAcquireCredentialsHandle 함수를 참조하세요.

SSP/AP는 SpAcceptCredentials 함수를 구현해야 합니다. 다른 SSP/AP 함수와 달리 함수의 이름은 SpAcceptCredentials여야 합니다.

LSA는 SpLsaModeInitialize 함수에서 받은 SECPKG_FUNCTION_TABLE 구조를 통해 SpAcceptCredentials 함수에 액세스합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntsecpkg.h