Funzione DsGetSiteNameA (dsgetdc.h)
La funzione DsGetSiteName restituisce il nome del sito in cui risiede un computer. Per un controller di dominio (DC), il nome del sito è il percorso del controller di dominio configurato. Per una workstation membro o un server membro, il nome specifica il sito della workstation come configurato nel dominio del computer.
Sintassi
DSGETDCAPI DWORD DsGetSiteNameA(
[in] LPCSTR ComputerName,
[out] LPSTR *SiteName
);
Parametri
[in] ComputerName
Puntatore a una stringa con terminazione null che specifica il nome del server per inviare questa funzione. Null implica il computer locale.
[out] SiteName
Puntatore a una variabile che riceve un puntatore a una stringa con terminazione null specificando il percorso del sito di questo computer. Questa stringa viene allocata dal sistema e deve essere liberata usando la funzione NetApiBufferFree .
Valore restituito
Se la funzione restituisce informazioni sull'account, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
Commenti
La funzione DsGetSiteName non richiede alcun accesso specifico al dominio specificato. La funzione viene inviata al servizio "NetLogon" nel computer specificato da ComputerName.
Nota
L'intestazione dsgetdc.h definisce DsGetSiteName 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
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | dsgetdc.h |
Libreria | Netapi32.lib |
DLL | Netapi32.dll |