다음을 통해 공유


BuildTrusteeWithObjectsAndSidA 함수(aclapi.h)

BuildTrusteeWithObjectsAndSid 함수는 ACE(개체별 액세스 제어 항목) 정보를 사용하여 TRUSTEE 구조를 초기화하고 구조체의 나머지 멤버를 기본값으로 초기화합니다. 호출자는 또한 트러스티의 보안 식별자를 나타내는 SID 구조를 지정합니다.

구문

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

매개 변수

[in, out] pTrustee

초기화할 TRUSTEE 구조체에 대한 포인터입니다. BuildTrusteeWithObjectsAndSid 함수는 메모리를 할당하지 않습니다. 이 매개 변수가 NULL 이거나 유효하지 않은 포인터인 경우 결과는 정의되지 않습니다.

[in, optional] pObjSid

트러스티 및 보안 개체에 대한 정보를 포함하는 OBJECTS_AND_SID 구조체에 대한 포인터입니다.

[in, optional] pObjectGuid

TRUSTEE 구조에 추가할 ObjectType GUID를 설명하는 GUID 구조체에 대한 포인터입니다.

[in, optional] pInheritedObjectGuid

TRUSTEE구조에 추가할 InheritedObjectType GUID를 설명하는 GUID 구조체에 대한 포인터입니다.

[in, optional] pSid

트러스티를 식별하는 SID 구조체에 대한 포인터입니다.

반환 값

없음

설명

이 함수는 TRUSTEE 및 OBJECTS_AND_SID 구조체에 대한 메모리 할당하지 않습니다.

개체별 A ACE에 대한 자세한 내용은 개체별 ACE를 참조하세요.

참고

aclapi.h 헤더는 BUILDTrusteeWithObjectsAndSid를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

Access Control

기본 Access Control 함수

BuildTrusteeWithName

BuildTrusteeWithObjectsAndName

BuildTrusteeWithSid

OBJECTS_AND_NAME

개체별 ACL

SE_OBJECT_TYPE

SID

트러스티