Funzione NetGetAnyDCName (lmaccess.h)
La funzione NetGetAnyDCName restituisce il nome di qualsiasi controller di dominio (DC) per un dominio attendibile direttamente dal server specificato.
Le applicazioni che supportano nomi di stile DNS devono chiamare la funzione DsGetDcName . Questa funzione può individuare qualsiasi controller di dominio in qualsiasi dominio, indipendentemente dal fatto che il dominio sia direttamente attendibile dal server specificato.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
LPCWSTR ServerName,
LPCWSTR DomainName,
LPBYTE *Buffer
);
Parametri
ServerName
Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
DomainName
Puntatore a una stringa costante che specifica il nome del dominio. Se questo parametro è NULL, viene usato il nome del controller di dominio per il dominio primario. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Buffer
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NERR_Success.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Non è possibile trovare controller di dominio. |
|
Il dominio specificato non è un dominio attendibile. |
|
Il lato client della relazione di trust viene interrotto. |
|
Il lato server della relazione di trust viene interrotto o la password viene interrotta. |
|
Il server che ha risposto non è un controller di dominio appropriato del dominio specificato. |
Commenti
Non è necessaria alcuna appartenenza a gruppi speciali per eseguire correttamente la funzione NetGetAnyDCName .
Se nome server specifica una workstation autonoma o un server autonomo, nessun nome di dominio è valido.
Se servername specifica una workstation membro di un dominio o un server membro di un dominio, il nome di dominio deve trovarsi nello stesso dominio del nome server.
Se servername specifica un controller di dominio, il nome di dominio deve essere uno dei domini attendibili dal dominio per cui il server è un controller. Il controller di dominio che questa chiamata trova è stato operativo almeno una volta durante questa chiamata.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | lmaccess.h (include Lm.h) |
| Libreria | Netapi32.lib |
| DLL | Netapi32.dll |