Función NetGetAnyDCName (lmaccess.h)
La función NetGetAnyDCName devuelve el nombre de cualquier controlador de dominio (DC) de un dominio de confianza directa del servidor especificado.
Las aplicaciones que admiten nombres de estilo DNS deben llamar a la función DsGetDcName . Esta función puede localizar cualquier controlador de dominio en cualquier dominio, independientemente de si el servidor especificado confía o no en él.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
LPCWSTR ServerName,
LPCWSTR DomainName,
LPBYTE *Buffer
);
Parámetros
ServerName
Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
DomainName
Puntero a una cadena constante que especifica el nombre del dominio. Si este parámetro es NULL, se usa el nombre del controlador de dominio para el dominio principal. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Buffer
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
No se encontró ningún controlador de dominio. |
|
El dominio especificado no es un dominio de confianza. |
|
El lado cliente de la relación de confianza se interrumpe. |
|
El lado servidor de la relación de confianza se interrumpe o se interrumpe la contraseña. |
|
El servidor que respondió no es un controlador de dominio adecuado del dominio especificado. |
Comentarios
No se requiere pertenencia a grupos especiales para ejecutar correctamente la función NetGetAnyDCName .
Si servername especifica una estación de trabajo independiente o un servidor independiente, no hay ningún nombre de dominio válido.
Si servername especifica una estación de trabajo que es miembro de un dominio o un servidor que es miembro de un dominio, el nombre de dominio debe estar en el mismo dominio que servername.
Si servername especifica un controlador de dominio, el nombre de dominio debe ser uno de los dominios de confianza del dominio para el que el servidor es un controlador. El controlador de dominio que encuentra esta llamada ha estado operativo al menos una vez durante esta llamada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lmaccess.h (include Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |