Función DsGetSiteNameA (dsgetdc.h)

La función DsGetSiteName devuelve el nombre del sitio donde reside un equipo. Para un controlador de dominio (DC), el nombre del sitio es la ubicación del controlador de dominio configurado. Para una estación de trabajo miembro o un servidor miembro, el nombre especifica el sitio de estación de trabajo tal como está configurado en el dominio del equipo.

Sintaxis

DSGETDCAPI DWORD DsGetSiteNameA(
  [in]  LPCSTR ComputerName,
  [out] LPSTR  *SiteName
);

Parámetros

[in] ComputerName

Puntero a una cadena terminada en null que especifica el nombre del servidor para enviar esta función. Una NULL implica el equipo local.

[out] SiteName

Puntero a una variable que recibe un puntero a una cadena terminada en NULL que especifica la ubicación del sitio de este equipo. El sistema asigna esta cadena y se debe liberar mediante la función NetApiBufferFree.

Valor devuelto

Si la función devuelve información de la cuenta, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Observaciones

La función DsGetSiteName no requiere ningún acceso concreto al dominio especificado. La función se envía al servicio "NetLogon" en el equipo especificado por NombreDeEquipo.

Nota

El encabezado dsgetdc.h define DsGetSiteName 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

DsGetDcName

DsValidateSubnetName

NetApiBufferFree