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

ConvertSecurityDescriptor 메서드는 보안 설명자를 한 형식에서 다른 형식으로 변환합니다.

구문

HRESULT ConvertSecurityDescriptor(
  [in]  VARIANT varSD,
  [in]  long    lDataFormat,
  [in]  long    lOutFormat,
  [out] VARIANT *pResult
);

[in] varSD

변환할 보안 설명자가 포함된 VARIANT 입니다. 이 VARIANT 의 형식은 lDataFormat 매개 변수로 정의됩니다.

[in] lDataFormat

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

varSD에는 IADsSecurityDescriptor 인터페이스에 대해 쿼리할 수 있는 VT_DISPATCH 포함되어 있습니다.

varSD에는 원시 데이터 형식의 | 보안 설명자가 포함된VT_I1 VT_ARRAY 포함되어 있습니다. 이는 SECURITY_DESCRIPTOR 구조체의 형식입니다.

varSD 에는 16진수 인코딩 문자열 형식의 원시 보안 설명자가 포함된 VT_BSTR 포함되어 있습니다.

[in] lOutFormat

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

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

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

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

[out] pResult

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

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