IADsSecurityUtility::GetSecurityDescriptor method (iads.h)

Artikel
02/29/2024

Metode GetSecurityDescriptor mengambil deskriptor keamanan untuk file, fileshare, atau kunci registri yang ditentukan.

Sintaks

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

Parameter

[in] varPath

String VARIAN yang berisi jalur objek untuk mengambil deskriptor keamanan.

File

Sintaks jalur file yang valid. Misalnya: "c:\specs\public\adxml.doc" atau "\adsi\public\dsclient.exe".

Sintaks jalur file yang valid untuk berbagi file. Misalnya: "\adsi\public".

Kunci Registri

Sintaks registri yang valid. Misalnya, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".

[in] lPathFormat

Berisi salah satu nilai ADS_PATHTYPE_ENUM yang menentukan format parameter varPath .

[in] lFormat

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

ADS_SD_FORMAT_IID

pVariant menerima VT_DISPATCH yang dapat dikueri untuk antarmuka IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

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

ADS_SD_FORMAT_HEXSTRING

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

[out] pVariant

Penunjuk ke VARIAN yang menerima pendeskripsi keamanan yang dikembalikan. Format deskriptor keamanan yang diambil ditentukan oleh parameter lFormat .

Nilai kembali

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

Persyaratan

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