IADsSecurityUtility：：GetSecurityDescriptor 方法 (iads.h)

项目
02/29/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

包含指定 varPath 参数格式的ADS_PATHTYPE_ENUM值之一。

[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 参数指定。

返回值

如果成功，则返回 S_OK ，否则返回 COM 或 Win32 错误代码。可能的错误代码包括以下内容。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	iads.h
DLL	Activeds.dll

另请参阅

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor

通过