IGroupPolicyObject::GetDSPath 方法 (gpedit.h)

GetDSPath 方法检索指定 GPO 节根目录的 Active Directory 路径。

语法

HRESULT GetDSPath(
  [in]  DWORD    dwSection,
  [out] LPOLESTR pszPath,
  [in]  int      cchMaxPath
);

parameters

[in] dwSection

指定 GPO 部分。 此参数的取值可为下列值之一:

GPO_SECTION_ROOT

根部分

GPO_SECTION_USER

“用户”部分

GPO_SECTION_MACHINE

“计算机”部分

[out] pszPath

指向接收路径的缓冲区的指针,采用 ADSI 格式 (LDAP://cn=user、ou=users、dc=coname、dc=com) 。

[in] cchMaxPath

指定 pszPath 缓冲区中可以存储的最大字符数。

返回值

如果方法成功,则返回值 S_OK。 否则,方法将返回平台 SDK 头文件 WinError.h 中定义的 COM 错误代码之一。

注解

如果调用 GetDSPath 方法并指定计算机 GPO,该方法会成功,但返回时, pszPath 参数包含一个空字符串。 这是因为计算机 GPO 没有 Active Directory 存储;它们只有文件系统存储。

若要检索 GPO 节根目录的文件系统路径,可以调用 GetFileSysPath 方法。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 gpedit.h
DLL Gpedit.dll

另请参阅

GetFileSysPath

GetPath

组策略接口

组策略概述

IGroupPolicyObject