Funzione DsGetSiteNameA (dsgetdc.h)
La funzione DsGetSiteName
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
[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 |