다음을 통해 공유

SpGetContextTokenFn 콜백 함수(ntsecpkg.h)

  • 아티클

가장할 토큰을 가져옵니다. SpGetContextToken 함수는 SSPI ImpersonateSecurityContext 함수에서 가장할 토큰을 가져오는 데 사용됩니다.

구문

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

매개 변수

[in] ContextHandle

가장할 컨텍스트에 대한 핸들입니다.

[out] ImpersonationToken

지정된 컨텍스트에 대한 토큰에 대한 핸들을 수신하는 포인터입니다. 핸들 또는 토큰을 먼저 복제하지 않고 핸들을 토큰에 반환합니다.

반환 값

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

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

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

설명

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

SpGetContextToken 함수에 대한 포인터는 SpUserModeInitialize 함수에서 받은 SECPKG_USER_FUNCTION_TABLE 구조체에서 사용할 수 있습니다.

요구 사항

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

추가 정보

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize