SpGetCredentialsFn 콜백 함수(ntsecpkg.h)

SpGetCredentials 함수는 사용자 개체에서 기본 및 추가 자격 증명을 검색합니다.

구문

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

[in] CredentialHandle

검색할 자격 증명에 대한 핸들입니다.

[out] Credentials

자격 증명을 수신하는 SecBuffer 구조체에 대한 포인터입니다.

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

함수가 실패하면 실패한 이유를 나타내는 NTSTATUS 코드를 반환합니다. 다음은 오류의 일반적인 이유와 함수가 반환해야 하는 오류 코드를 나열합니다.

반환 코드	설명
SEC_E_INSUFFICIENT_MEMORY	자격 증명을 검색할 메모리가 충분하지 않습니다.
SEC_E_INVALID_HANDLE	핸들이 잘못되었습니다.

SSP/AP는 SpGetCredentials 함수를 구현해야 합니다. 그러나 구현에 지정된 실제 이름은 개발자에게 달려 있습니다.

SpGetCredentials 함수에 대한 포인터는 SpLsaModeInitialize 함수에서 받은 SECPKG_FUNCTION_TABLE 구조체에서 사용할 수 있습니다.