MakeSelfRelativeSD 함수(securitybaseapi.h)

MakeSelfRelativeSD 함수는 절대 형식의 보안 설명자를 템플릿으로 사용하여 자체 상대 형식의 보안 설명자를 만듭니다.

구문

BOOL MakeSelfRelativeSD(
  [in]            PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor,
  [out, optional] PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor,
  [in, out]       LPDWORD              lpdwBufferLength
);

매개 변수

[in] pAbsoluteSecurityDescriptor

절대 형식의 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 함수는 원본을 수정하지 않고 이 보안 설명자의 버전을 자체 상대 형식으로 만듭니다.

[out, optional] pSelfRelativeSecurityDescriptor

함수가 자체 상대 형식의 보안 설명자로 채우는 버퍼에 대한 포인터입니다.

[in, out] lpdwBufferLength

pSelfRelativeSD 매개 변수가 가리키는 버퍼의 크기를 지정하는 변수에 대한 포인터입니다. 버퍼가 보안 설명자에 대해 충분히 크지 않으면 함수가 실패하고 이 변수를 필요한 최소 크기로 설정합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드/값	설명
ERROR_INSUFFICIENT_BUFFER 0x7A	하나 이상의 버퍼가 너무 작습니다.

설명

절대 형식의 보안 설명자는 정보 자체를 포함하지 않고 포함된 정보에 대한 포인터를 포함합니다. 자체 상대 형식의 보안 설명자는 인접한 메모리 블록의 정보를 포함합니다. 자체 상대 보안 설명자에서 SECURITY_DESCRIPTOR 구조는 항상 정보를 시작하지만 보안 설명자의 다른 구성 요소는 어떤 순서로든 구조를 따를 수 있습니다. 메모리 주소를 사용하는 대신 보안 설명자의 구성 요소는 보안 설명자의 시작 부분에서 오프셋으로 식별됩니다. 이 형식은 보안 설명자를 플로피 디스크에 저장하거나 통신 프로토콜을 통해 전송해야 하는 경우에 유용합니다.

보안 개체를 다양한 미디어에 복사하는 서버는 MakeSelfRelativeSD 함수를 사용하여 절대 보안 설명자에서 자기 상대 보안 설명자를 만들고 MakeAbsoluteSD 함수를 사용하여 자기 상대 보안 설명자에서 절대 보안 설명자를 만들 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	securitybaseapi.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Advapi32.dll

추가 정보

하위 수준 Access Control

하위 수준 Access Control 함수

MakeAbsoluteSD

SECURITY_DESCRIPTOR