Método IGPEInformation::GetDSPath (gpedit.h)
O método GetDSPath recupera o caminho do Active Directory para a seção especificada do GPO.
Sintaxe
HRESULT GetDSPath(
[in] DWORD dwSection,
[out] LPOLESTR pszPath,
[in] int cchMaxPath
);
Parâmetros
[in] dwSection
Especifica a seção GPO. Esse parâmetro pode usar um dos valores a seguir.
GPO_SECTION_ROOT
Seção raiz
GPO_SECTION_USER
Seção de usuário
GPO_SECTION_MACHINE
Seção Computador
[out] pszPath
Recebe o caminho do Active Directory para a raiz da seção solicitada. Para obter mais informações, consulte a seção Comentários a seguir.
[in] cchMaxPath
Especifica o tamanho, em caracteres, do parâmetro pszPath .
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos no arquivo de cabeçalho do SDK da Plataforma WinError.h.
Comentários
Se você chamar o método GetDSPath e especificar um GPO do computador, o método terá êxito, mas, no retorno, o parâmetro pszPath conterá uma cadeia de caracteres vazia. Isso ocorre porque os GPOs do computador não têm armazenamento do Active Directory; eles têm apenas o armazenamento do sistema de arquivos.
Para recuperar o caminho do sistema de arquivos para a seção especificada de um GPO, você pode chamar o método GetFileSysPath .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | gpedit.h |
| DLL | Gpedit.dll |