IADsSecurityUtility::ConvertSecurityDescriptor method (iads.h)

Artikel
08/24/2023

Metode ConvertSecurityDescriptor mengonversi deskriptor keamanan dari satu format ke format lainnya.

Sintaks

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

Parameter

[in] varSD

VARIAN yang berisi deskriptor keamanan untuk dikonversi. Format VARIAN ini ditentukan oleh parameter lDataFormat .

[in] lDataFormat

Berisi salah satu nilai ADS_SD_FORMAT_ENUM yang menentukan format deskriptor keamanan dalam parameter varSD . Daftar berikut mengidentifikasi nilai yang mungkin untuk parameter ini dan format parameter varSD .

ADS_SD_FORMAT_IID

varSD berisi VT_DISPATCH yang dapat dikueri untuk antarmuka IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

varSD berisi VT_ARRAY VT_I1 | yang berisi deskriptor keamanan dalam format data mentah. Ini dalam format struktur SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

varSD berisi VT_BSTR yang berisi deskriptor keamanan mentah dalam format string enkode hex.

[in] lOutFormat

Berisi salah satu nilai ADS_SD_FORMAT_ENUM yang menentukan format tempat deskriptor keamanan harus dikonversi. Daftar berikut mengidentifikasi nilai yang mungkin untuk parameter ini dan format parameter pvResult .

ADS_SD_FORMAT_IID

pvResult menerima VT_DISPATCH yang dapat dikueri untuk antarmuka IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

pvResult menerima VT_ARRAY VT_I1 | yang berisi deskriptor keamanan dalam format data mentah. Ini dalam format struktur SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

pvResult menerima VT_BSTR yang berisi deskriptor keamanan mentah dalam format string enkode hex.

[out] pResult

Penunjuk ke VARIAN yang menerima deskriptor keamanan yang dikonversi. Format deskriptor keamanan yang diambil ditentukan oleh parameter lOutFormat .

Menampilkan nilai

Mengembalikan S_OK jika berhasil atau kode kesalahan COM atau Win32 sebaliknya. Kemungkinan kode kesalahan termasuk yang berikut ini.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll