Condividi tramite


Funzione DsGetSiteNameA (dsgetdc.h)

La funzione DsGetSiteName restituisce il nome del sito in cui risiede un computer. Per un controller di dominio ,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 da inviare a questa funzione. Un NULL implica il computer locale.

[out] SiteName

Puntatore a una variabile che riceve un puntatore a una stringa con terminazione Null che specifica il percorso del sito del 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.

Osservazioni

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

DsGetDcName

DsValidateSubnetName

NetApiBufferFree