Método IGPM::GetDomain (gpmgmt.h)

  • Artículo

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

Consulte también

IGPM

IGPMDomain