IADsSecurityUtility：：GetSecurityDescriptor 方法 (iads.h)

發行項
02/26/2024

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

包含其中一個 ADS_PATHTYPE_ENUM 值，指定 varPath 參數的格式。

[in] lFormat

包含其中一個 ADS_SD_FORMAT_ENUM 值，指定 pVariant 參數中傳回的安全性描述元格式。下列清單會識別此參數的可能值，以及 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 會接收 VT_BSTR ，其中包含十六進位編碼字元串格式的原始安全性描述元。

[out] pVariant

接收傳回之安全性描述元之 VARIANT 的指標。擷取的安全性描述元格式是由 lFormat 參數所指定。

傳回值

如果成功或 COM 或 Win32 錯誤碼，則傳回 S_OK 否則傳回。可能的錯誤碼包括下列專案。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	iads.h
Dll	Activeds.dll

另請參閱

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor

共用方式為