AuthzInitializeContextFromToken 함수(authz.h)

AuthzInitializeContextFromToken 함수는 커널 토큰에서 클라이언트 권한 부여 컨텍스트를 초기화합니다. 커널 토큰은 TOKEN_QUERY 위해 열려 있어야 합니다.

Windows Server 2012 및 Windows 8 이 함수는 디바이스 그룹, 사용자 클레임 및 디바이스 클레임을 복사할 수도 있습니다.

구문

AUTHZAPI BOOL AuthzInitializeContextFromToken(
  [in]           DWORD                         Flags,
  [in]           HANDLE                        TokenHandle,
  [in]           AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in, optional] PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

매개 변수

[in] Flags

다음에 사용하도록 예약됩니다.

[in] TokenHandle

pAuthzClientContext 매개 변수를 초기화하는 데 사용되는 클라이언트 토큰에 대한 핸들입니다. 토큰은 TOKEN_QUERY 액세스 권한으로 열렸어야 합니다.

[in] hAuthzResourceManager

이 클라이언트 컨텍스트를 만든 리소스 관리자에 대한 핸들입니다. 이 핸들은 클라이언트 컨텍스트 구조에 저장됩니다.

[in, optional] pExpirationTime

토큰의 만료 날짜 및 시간입니다. 값이 전달되지 않으면 토큰이 만료되지 않습니다. 만료 시간은 현재 적용되지 않습니다.

[in] Identifier

리소스 관리자와 관련된 식별자입니다. 이 매개 변수는 현재 사용되지 않습니다.

[in, optional] DynamicGroupArgs

동적 그룹을 계산하는 콜백 함수에 전달할 매개 변수에 대한 포인터입니다.

[out] phAuthzClientContext

반환된 AuthzClientContext 핸들에 대한 포인터입니다. 클라이언트 컨텍스트로 완료되면 AuthzFreeContext 를 호출합니다.

반환 값

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

함수가 실패하면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 AuthzComputeGroupsCallback 콜백 함수를 호출하여 새로 만든 컨텍스트에 보안 식별자를 추가합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	authz.h
라이브러리	Authz.lib
DLL	Authz.dll
재배포 가능 파일	Windows XP의 Windows Server 2003 관리 도구 팩

추가 정보

AuthzFreeContext

기본 Access Control 함수