Funzione DsAddressToSiteNamesExA (dsgetdc.h)

La funzione DsAddressToSiteNamesEx ottiene i nomi del sito e della subnet corrispondenti agli indirizzi specificati.

Sintassi

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

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 del 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 a un sito noto o se la voce dell'indirizzo non è del modulo appropriato. Il chiamante deve liberare questa matrice quando non è più necessaria chiamando NetApiBufferFree.

[out] SubnetNames

Riceve una matrice di puntatori stringa con terminazione null che contengono i nomi di subnet usati per eseguire il mapping dei nomi del sito. Ogni elemento di questa matrice corrisponde allo stesso elemento nella matrice SocketAddresses . Un elemento è NULL se l'indirizzo corrispondente al mapping dei nomi del sito non è stato determinato o se non è stata usata alcuna subnet per eseguire l'indirizzo corrispondente al mapping del sito. Quest'ultimo sarà il caso in cui si trova esattamente un sito nell'organizzazione senza oggetti subnet mappati a esso. 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. Di seguito sono riportati i codici di errore possibili.

Commenti

Nota

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

Requisiti

Requisito	Valore
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

DsAddressToSiteNames

Dsgetdcname

NetApiBufferFree