Función DsAddressToSiteNamesExA (dsgetdc.h)

La función DsAddressToSiteNamesEx obtiene los nombres de sitio y subred correspondientes a las direcciones especificadas.

Sintaxis

DSGETDCAPI DWORD DsAddressToSiteNamesExA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames,
  [out]          LPSTR           **SubnetNames
);

Parámetros

[in, optional] ComputerName

Puntero a una cadena terminada en null que especifica el nombre del servidor remoto para procesar esta función. Este parámetro debe ser el nombre de un controlador de dominio. Un controlador que no es de dominio puede llamar a esta función llamando a DsGetDcName para buscar el controlador de dominio.

[in] EntryCount

Contiene el número de elementos de la matriz SocketAddresses .

[in] SocketAddresses

Contiene una matriz de estructuras de SOCKET_ADDRESS que contienen las direcciones que se van a convertir. Cada dirección de esta matriz debe ser del tipo AF_INET. EntryCount contiene el número de elementos de esta matriz.

[out] SiteNames

Recibe una matriz de punteros de cadena terminadas en null que contienen los nombres de sitio de las direcciones. Cada elemento de esta matriz corresponde al mismo elemento de la matriz SocketAddresses . Un elemento es NULL si la dirección correspondiente no se asigna a ningún sitio conocido o si la entrada de dirección no tiene el formato adecuado. El autor de la llamada debe liberar esta matriz cuando ya no sea necesaria mediante una llamada a NetApiBufferFree.

[out] SubnetNames

Recibe una matriz de punteros de cadena terminadas en NULL que contienen los nombres de subred usados para realizar las asignaciones de direcciones a nombres de sitio. Cada elemento de esta matriz corresponde al mismo elemento de la matriz SocketAddresses . Un elemento es NULL si la dirección correspondiente a la asignación de nombres de sitio no se determinó o si no se usó ninguna subred para realizar la dirección correspondiente a la asignación de sitio. Este último será el caso cuando haya exactamente un sitio en la empresa sin ningún objeto de subred asignado. El autor de la llamada debe liberar esta matriz cuando ya no sea necesaria mediante una llamada a NetApiBufferFree.

Valor devuelto

Devuelve NO_ERROR si se ejecuta correctamente o si se produce un error de Win32 o RPC en caso contrario. A continuación se muestran códigos de error posibles.

Comentarios

Nota

El encabezado dsgetdc.h define DsAddressToSiteNamesEx 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsgetdc.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

Funciones del servicio de directorio

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree