Método IGroupPolicyObject::GetDSPath (gpedit.h)

Artículo
08/24/2023

El método GetDSPath recupera la ruta de acceso de Active Directory a la raíz de la sección de GPO especificada.

Sintaxis

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

Parámetros

[in] dwSection

Especifica la sección GPO. Este parámetro puede ser uno de los valores siguientes.

GPO_SECTION_ROOT

Sección raíz

GPO_SECTION_USER

Sección Usuario

GPO_SECTION_MACHINE

Sección Equipo

[out] pszPath

Puntero a un búfer que recibe la ruta de acceso, en formato ADSI (LDAP://cn=user, ou=users, dc=coname, dc=com).

[in] cchMaxPath

Especifica el número máximo de caracteres que se pueden almacenar en el búfer pszPath .

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en el archivo de encabezado de Platform SDK WinError.h.

Comentarios

Si llama al método GetDSPath y especifica un GPO de equipo, el método se realiza correctamente, pero a cambio, el parámetro pszPath contiene una cadena vacía. Esto se debe a que los GPO de equipo no tienen almacenamiento de Active Directory; solo tienen almacenamiento del sistema de archivos.

Para recuperar la ruta de acceso del sistema de archivos a la raíz de una sección de GPO, puede llamar al método GetFileSysPath .

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	gpedit.h
Archivo DLL	Gpedit.dll