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

Vedi anche

Funzioni del servizio directory

Dsgetdcname

DsValidateSubnetName

NetApiBufferFree