SpQueryCredentialsAttributesFn 콜백 함수(ntsecpkg.h)

  • 아티클

SpQueryCredentialsAttributes 함수는 자격 증명에 대한 특성을 검색합니다.

SpQueryCredentialsAttributes 함수는 보안 지원 공급자 인터페이스의 QueryCredentialsAttributes 함수에 대한 디스패치 함수입니다.

구문

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

매개 변수

[in] CredentialHandle

쿼리할 자격 증명에 대한 핸들입니다.

[in] CredentialAttribute

쿼리할 특성입니다. 다음 표에는 유효한 값이 나와 있습니다.

값 의미
SECPKG_CRED_ATTR_NAMES
 자격 증명과 연결된 보안 주체의 이름입니다.
SECPKG_ATTR_SUPPORTED_ALGS
 특정 자격 증명에서 지원되는 알고리즘입니다.
SECPKG_ATTR_CIPHER_STRENGTHS
 자격 증명과 함께 사용되는 최소 및 최대 암호 강도입니다.
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 특정 자격 증명에서 지원되는 프로토콜입니다.

[out] Buffer

요청된 특성을 수신하는 버퍼에 대한 포인터입니다. 호출자가 FreeContextBuffer 함수를 호출하여 해제할 수 있도록 AllocateClientBuffer 함수를 사용하여 이 버퍼에 대한 메모리를 할당합니다.

반환 값

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

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

반환 코드 설명
SEC_E_INSUFFICIENT_MEMORY
 메모리 할당이 실패했습니다.
SEC_E_INVALID_HANDLE
 자격 증명 핸들이 잘못되었습니다.

설명

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

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

요구 사항

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

추가 정보

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize