Función DsGetDcOpenA (dsgetdc.h)
La función DsGetDcOpen abre una nueva operación de enumeración del controlador de dominio.
Sintaxis
DSGETDCAPI DWORD DsGetDcOpenA(
[in] LPCSTR DnsName,
[in] ULONG OptionFlags,
[in, optional] LPCSTR SiteName,
[in, optional] GUID *DomainGuid,
[in, optional] LPCSTR DnsForestName,
[in] ULONG DcFlags,
[out] PHANDLE RetGetDcContext
);
Parámetros
[in] DnsName
Puntero a una cadena terminada en null que contiene el nombre del sistema de nomenclatura de dominio (DNS) del dominio para el que se van a enumerar los controladores de dominio. Este parámetro no puede ser NULL.
[in] OptionFlags
Contiene un conjunto de marcas que modifican el comportamiento de la función. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DS_ONLY_DO_SITE_NAME
Solo se enumeran los controladores de dominio específicos del sitio.
DS_NOTIFY_AFTER_SITE_RECORDS
La función DsGetDcNext devolverá el valor de ERROR_FILEMARK_DETECTED después de recuperar todos los controladores de dominio específicos del sitio. DsGetDcNext enumerará el segundo grupo, que contiene todos los controladores de dominio del dominio, incluidos los controladores de dominio específicos del sitio contenidos en el primer grupo.
[in, optional] SiteName
Puntero a una cadena terminada en null que contiene el nombre del sitio en el que se encuentra el cliente. Este parámetro es opcional y puede ser null.
[in, optional] DomainGuid
Puntero a un GUID de
[in, optional] DnsForestName
Puntero a una cadena terminada en null que contiene el nombre del bosque que contiene el dominio DnsName. Este valor se usa junto con DomainGuid para enumerar los controladores de dominio si se ha cambiado el nombre del dominio. Este parámetro es opcional y puede ser null.
[in] DcFlags
Contiene un conjunto de marcas que identifican el tipo de controladores de dominio que se van a enumerar. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DS_FORCE_REDISCOVERY
Fuerza la omisión de los datos del controlador de dominio almacenados en caché. Cuando no se especifica esta marca, DsGetDcOpen obtiene la enumeración del controlador de dominio de los datos del controlador de dominio almacenados en caché.
DS_GC_SERVER_REQUIRED
Requiere que los controladores de dominio enumerados sean servidores de catálogo global para el bosque de dominios con este dominio como raíz. Esta marca no se puede combinar con la marca DS_PDC_REQUIRED.
DS_KDC_REQUIRED
Requiere que los controladores de dominio enumerados ejecuten actualmente el servicio centro de distribución de claves Kerberos. Esta marca no se puede combinar con las marcas DS_PDC_REQUIRED o DS_GC_SERVER_REQUIRED.
DS_ONLY_LDAP_NEEDED
Especifica que los servidores enumerados son servidores LDAP. Los servidores no son necesariamente controladores de dominio. No se implica que ningún otro servicio esté presente en cada servidor enumerado. Los servidores no tienen necesariamente una configuración de escritura contenedor ni un contenedor de esquemas grabable. Es posible que los servidores no se usen necesariamente para crear o modificar principios de seguridad. Esta marca se puede usar con la marca DS_GC_SERVER_REQUIRED para enumerar los servidores LDAP que también hospedan un servidor de catálogo global. En ese caso, los servidores de catálogo global enumerados no son necesariamente controladores de dominio y otros servicios están implícitos en estar presentes en cada servidor. Si se especifica esta marca, se omiten las marcas DS_PDC_REQUIRED, DS_TIMESERV_REQUIRED, DS_GOOD_TIMESERV_PREFERRED, DS_DIRECTORY_SERVICES_PREFERED, DS_DIRECTORY_SERVICES_REQUIREDy DS_KDC_REQUIRED.
DS_PDC_REQUIRED
Requiere que los controladores de dominio enumerados sean los controladores de dominio principales para el dominio. Esta marca no se puede combinar con la marca DS_GC_SERVER_REQUIRED.
[out] RetGetDcContext
Puntero a un valor handle que recibe el identificador de contexto de enumeración del controlador de dominio. Este identificador se usa con la función DsGetDcNext para identificar la operación de enumeración del controlador de dominio. Este identificador se pasa a DsGetDcClose para cerrar la operación de enumeración del controlador de dominio.
Valor devuelto
Devuelve ERROR_SUCCESS si se ejecuta correctamente o si se produce un error win32 o RPC de otro modo. Entre los posibles valores de error se incluyen los siguientes.
Observaciones
Nota
El encabezado dsgetdc.h define DsGetDcOpen como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de |
Windows |
| encabezado de |
dsgetdc.h |
| biblioteca de |
Netapi32.lib |
| DLL de |
Netapi32.dll |
Consulte también
funciones del servicio de directorio de