Método IGPM::GetDomain (gpmgmt.h)
Crea y devuelve un objeto GPMDomain que corresponde al dominio especificado.
El objeto permite hacer lo siguiente:
- Creación, consulta y restauración de objetos directiva de grupo (GPO)
- Ámbito de búsqueda de objetos de administración (SOM)
- Buscar y recuperar filtros de Instrumental de administración de Windows (WMI)
Sintaxis
HRESULT GetDomain(
[in] BSTR bstrDomain,
[in] BSTR bstrDomainController,
[in] long lDCFlags,
[out] IGPMDomain **pIGPMDomain
);
Parámetros
[in] bstrDomain
Nombre del dominio especificado como una cadena. Debe ser un nombre completo del Sistema de nombres de dominio (DNS), como contoso.com.
[in] bstrDomainController
Si se especifica, el nombre del controlador de dominio que se va a usar con el dominio. El nombre puede ser un nombre DNS o un nombre NetBIOS. De lo contrario, el método usa el controlador de dominio principal (PDC). Para obtener más información, consulte el parámetro lDCFlags .
Scripting: Este parámetro debe pasar una cadena vacía ("") cuando no se especifica un controlador de dominio.
[in] lDCFlags
Marcas que se usarán para buscar el controlador de dominio del dominio. Puede especificar GPM_USE_ANYDC, GPM_USE_PDC o GPM_DONOTUSE_W2KDC.
Si este parámetro se establece en cero y se especifica bstrDomainController , el método usa el bstrDomainController especificado. De lo contrario, el método usa el PDC.
[out] pIGPMDomain
Dirección de un puntero a la interfaz IGPMDomain .
Valor devuelto
C++
Devuelve S_OK si se ejecuta correctamente. Devuelve un código de error si se produce un error.JScript
Devuelve una referencia a un objeto GPMDomain .VB
Devuelve una referencia a un objeto GPMDomain .Comentarios
Importante: Al llamar a esta función, el tráfico LDAP subyacente se cifra mediante Kerberos, no SSL.
Este método no permite buscar SOM del sitio. Llame al método IGPM::GetSitesContainer para realizar este tipo de consulta.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | gpmgmt.h |
| Archivo DLL | Gpmgmt.dll |