Funzione DsAddressToSiteNamesA (dsgetdc.h)

La funzione DsAddressToSiteNames ottiene i nomi del sito corrispondenti agli indirizzi specificati.

Sintassi

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

Parametri

[in, optional] ComputerName

Puntatore a una stringa con terminazione Null che specifica il nome del server remoto per elaborare questa funzione. Questo parametro deve essere il nome di un controller di dominio. Un controller non di dominio può chiamare questa funzione chiamando DsGetDcName per trovare il controller di dominio.

[in] EntryCount

Contiene il numero di elementi nella matrice SocketAddresses .

[in] SocketAddresses

Contiene una matrice di strutture SOCKET_ADDRESS che contengono gli indirizzi da convertire. Ogni indirizzo in questa matrice deve essere di tipo AF_INET. EntryCount contiene il numero di elementi in questa matrice.

[out] SiteNames

Riceve una matrice di puntatori di stringa con terminazione Null che contengono i nomi del sito per gli indirizzi. Ogni elemento in questa matrice corrisponde allo stesso elemento nella matrice SocketAddresses . Un elemento è NULL se l'indirizzo corrispondente non esegue il mapping ad alcun sito noto o se la voce dell'indirizzo non è del formato corretto. Il chiamante deve liberare questa matrice quando non è più necessaria chiamando NetApiBufferFree.

Valore restituito

Restituisce NO_ERROR se ha esito positivo o un errore Win32 o RPC in caso contrario. Nell'elenco seguente sono elencati i possibili codici di errore.

Commenti

Nota

L'intestazione dsgetdc.h definisce DsAddressToSiteNames come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsgetdc.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

Funzioni del servizio directory

DsAddressToSiteNamesEx

Dsgetdcname

NetApiBufferFree