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

Artículo
03/05/2024

El método GetDSPath recupera la ruta de acceso de Active Directory para la sección especificada del GPO.

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

Recibe la ruta de acceso de Active Directory a la raíz de la sección solicitada. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] cchMaxPath

Especifica el tamaño, en caracteres, del parámetro pszPath .

Valor devuelto

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

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 para la sección especificada de un GPO, puede llamar al método GetFileSysPath .

Requisitos

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