IADsSecurityUtility::GetSecurityDescriptor 메서드(iads.h)

GetSecurityDescriptor 메서드는 지정된 파일, 파일 공유 또는 레지스트리 키에 대한 보안 설명자를 검색합니다.

구문

HRESULT GetSecurityDescriptor(
  [in]  VARIANT varPath,
  [in]  long    lPathFormat,
  [in]  long    lFormat,
  [out] VARIANT *pVariant
);

매개 변수

[in] varPath

보안 설명자를 검색할 개체의 경로를 포함하는 VARIANT 문자열입니다.

파일

유효한 파일 경로 구문입니다. 예: "c:\specs\public\adxml.doc" 또는 "\adsi\public\dsclient.exe".

파일 공유

파일 공유에 대한 유효한 파일 경로 구문입니다. 예: "\adsi\public".

레지스트리 키

유효한 레지스트리 구문입니다. 예를 들어 "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs"입니다.

[in] lPathFormat

varPath 매개 변수의 형식을 지정하는 ADS_PATHTYPE_ENUM 값 중 하나를 포함합니다.

[in] lFormat

pVariant 매개 변수에 반환된 보안 설명자의 형식을 지정하는 ADS_SD_FORMAT_ENUM 값 중 하나를 포함합니다. 다음 목록에서는 이 매개 변수의 가능한 값과 pVariant 매개 변수에 제공되는 형식을 식별합니다.

ADS_SD_FORMAT_IID

pVariant는 IADsSecurityDescriptor 인터페이스에 대해 쿼리할 수 있는 VT_DISPATCH 받습니다.

ADS_SD_FORMAT_RAW

pVariant는 원시 데이터 형식의 | 보안 설명자를 포함하는VT_I1 VT_ARRAY 받습니다. 이는 SECURITY_DESCRIPTOR 구조체의 형식입니다.

ADS_SD_FORMAT_HEXSTRING

pVariant 는 16진수 인코딩 문자열 형식의 원시 보안 설명자를 포함하는 VT_BSTR 받습니다.

[out] pVariant

반환된 보안 설명자를 수신하는 VARIANT 에 대한 포인터입니다. 검색된 보안 설명자의 형식은 lFormat 매개 변수에 의해 지정됩니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 COM 또는 Win32 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	iads.h
DLL	Activeds.dll

추가 정보

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor