Función DsAddressToSiteNamesA (dsgetdc.h)
La función DsAddressToSiteNames obtiene los nombres de sitio correspondientes a las direcciones especificadas.
Sintaxis
DSGETDCAPI DWORD DsAddressToSiteNamesA(
[in, optional] LPCSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPSTR **SiteNames
);
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 matriz. 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 necesario llamando a NetApiBufferFree.
Valor devuelto
Devuelve NO_ERROR si se ejecuta correctamente o un error win32 o RPC de lo contrario. En la lista siguiente se enumeran los posibles códigos de error.
Observaciones
Nota
El encabezado dsgetdc.h define DsAddressToSiteNames 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