Método IGroupPolicyObject::GetDSPath (gpedit.h)
O método GetDSPath recupera o caminho do Active Directory para a raiz da seção GPO especificada.
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
Ponteiro para um buffer que recebe o caminho, no formato ADSI (LDAP://cn=user, ou=users, dc=coname, dc=com).
[in] cchMaxPath
Especifica o número máximo de caracteres que podem ser armazenados no buffer pszPath .
Valor retornado
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 raiz de uma seção GPO, você pode chamar o método GetFileSysPath .
Requisitos
| 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 |