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 stringa con terminazione Null che contengono i nomi del sito per gli indirizzi. Ogni elemento di 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 in caso di esito positivo o di errore Win32 o RPC in caso contrario. Nell'elenco seguente sono elencati i possibili codici di errore.
Osservazioni
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
dsgetdc.h |
| libreria |
Netapi32.lib |
| dll | Netapi32.dll |