Funzione DsAddressToSiteNamesExA (dsgetdc.h)

Articolo
11/20/2024

La funzione DsAddressToSiteNamesEx ottiene i nomi di sito e 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 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.

[out] SubnetNames

Riceve una matrice di puntatori stringa con terminazione Null che contengono i nomi di subnet usati per eseguire il mapping dell'indirizzo ai 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 il mapping dell'indirizzo corrispondente al sito. Quest'ultimo sarà il caso in cui è presente esattamente un sito nell'organizzazione senza oggetti subnet mappati. 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. Di seguito sono riportati i possibili codici di errore.

Osservazioni

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

Vedere anche

funzioni del servizio directory

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree

Condividi tramite