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

  • Artículo

Crea y devuelve un objeto GPMSitesContainer desde el que se pueden abrir y consultar los sitios.

Sintaxis

HRESULT GetSitesContainer(
  [in]  BSTR               bstrForest,
  [in]  BSTR               bstrDomain,
  [in]  BSTR               bstrDomainController,
  [in]  long               lDCFlags,
  [out] IGPMSitesContainer **ppIGPMSitesContainer
);

Parámetros

[in] bstrForest

Necesario. Nombre DNS completo del bosque en el que se va a acceder a los sitios; este es el nombre del dominio raíz del bosque. Use una cadena terminada en null.

[in] bstrDomain

Nombre del dominio en el que se va a acceder a los sitios. Si se especifica, debe ser un nombre completo del servidor de nombres de dominio (DNS), como example.microsoft.com. Si se especifica un dominio en el parámetro bstrDomain, la consola de administración de directiva de grupo (GPMC) accede a los sitios a través de ese dominio. Si no se especifica ningún dominio, el GPMC accede a los sitios a través del bosque especificado en el parámetro bstrForest . Use una cadena terminada en NULL.

[in] bstrDomainController

Si se especifica, el nombre del controlador de dominio que se va a usar con el dominio especificado en el parámetro bstrDomain . El nombre puede ser un nombre DNS o un nombre NetBIOS. De lo contrario, el método usa el controlador de dominio principal (PDC). Use una cadena terminada en NULL.

[in] lDCFlags

Marcas que se usarán para buscar el controlador de dominio del dominio. Actualmente, el único valor admitido es GPM_USE_ANYDC. Si este parámetro se establece en cero y se especifica bstrDomainController , el método usa el controlador de dominio especificado. De lo contrario, el método usa el PDC.

[out] ppIGPMSitesContainer

Dirección de un puntero a la interfaz IGPMSitesContainer .

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 GPMSitesContainer .

VB

Devuelve una referencia a un objeto GPMSitesContainer .

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

IGPMSitesContainer