SpQueryContextAttributesFn 콜백 함수(ntsecpkg.h)

SpQueryContextAttributes 함수는 보안 컨텍스트의 특성을 검색합니다.

SpQueryContextAttributes 함수는 보안 지원 공급자 인터페이스의 QueryContextAttributes(일반) 함수에 대한 디스패치 함수입니다.

구문

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

매개 변수

[in] ContextHandle

보안 컨텍스트에 대한 핸들입니다.

[in] ContextAttribute

쿼리할 컨텍스트 특성입니다. 유효한 값 목록은 QueryContextAttributes(일반) 함수를 참조하세요.

[out] Buffer

요청된 특성을 포함하는 버퍼의 주소를 수신하는 포인터입니다. Buffer 매개 변수에 대한 메모리는 사용자 모드에서 SECPKG_DLL_FUNCTIONS 함수 테이블의 AllocateHeap 함수와 함께 할당되어야 합니다. LSA( 로컬 보안 기관 ) 모드에서 AllocateLsaHeap 함수를 사용합니다.

반환 값

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

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

반환 코드	설명
SEC_E_INVALID_HANDLE	핸들이 잘못되었습니다.

설명

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

SpQueryContextAttributes 함수의 LSA 모드 구현에 대한 포인터는 SpLsaModeInitialize 함수에서 받은 SECPKG_FUNCTION_TABLE 구조에서 사용할 수 있습니다.

SpQueryContextAttributes 함수의 사용자 모드 구현에 대한 포인터는 SpUserModeInitialize 함수에서 받은 SECPKG_USER_FUNCTION_TABLE 구조에서 사용할 수 있습니다.

요구 사항

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

추가 정보

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize