Función NetGetAnyDCName (lmaccess.h)

Artículo
03/09/2023

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
ERROR_NO_LOGON_SERVERS	No se encontró ningún controlador de dominio.
ERROR_NO_SUCH_DOMAIN	El dominio especificado no es un dominio de confianza.
ERROR_NO_TRUST_LSA_SECRET	El lado cliente de la relación de confianza se interrumpe.
ERROR_NO_TRUST_SAM_ACCOUNT	El lado servidor de la relación de confianza se interrumpe o se interrumpe la contraseña.
ERROR_DOMAIN_TRUST_INCONSISTENT	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