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

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

[in] lFormat

包含其中一個 ADS_SD_FORMAT_ENUM 值，指定 pVariant 參數中傳回的安全性描述元格式。下列清單會識別此參數的可能值，以及 pVariant 參數中提供的格式。

pVariant 會接收可查詢 IADsSecurityDescriptor 介面的VT_DISPATCH。

pVariant 會接收VT_I1 VT_ARRAY | ，其中包含原始數據格式的安全性描述元。這是 SECURITY_DESCRIPTOR 結構的格式。

pVariant 會接收 VT_BSTR ，其中包含十六進位編碼字元串格式的原始安全性描述元。

[out] pVariant

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

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