Funzione DsBindA (ntdsapi.h)
La funzione DsBind viene associata a un controller di dominio. DsBind usa le credenziali di processo predefinite per l'associazione al controller di dominio. Per specificare credenziali alternative, usare la funzione DsBindWithCred .
Sintassi
NTDSAPI DWORD DsBindA(
[in, optional] LPCSTR DomainControllerName,
[in, optional] LPCSTR DnsDomainName,
[out] HANDLE *phDS
);
Parametri
[in, optional] DomainControllerName
Puntatore a una stringa con terminazione Null contenente il nome del controller di dominio a cui eseguire l'associazione. Questo nome può essere il nome del controller di dominio o il nome DNS completo del controller di dominio. Entrambi i tipi di nome possono, facoltativamente, essere preceduti da due caratteri barra rovesciata. Tutti gli esempi seguenti rappresentano nomi di controller di dominio formattati correttamente:
- "FAB-DC-01"
- "\\FAB-DC-01"
- "FAB-DC-01.fabrikam.com"
- "\\FAB-DC-01.fabrikam.com"
[in, optional] DnsDomainName
Puntatore a una stringa con terminazione Null contenente il nome DNS completo del dominio a cui eseguire l'associazione. Questo parametro può essere NULL. Per altre informazioni, vedere la sezione Osservazioni.
[out] phDS
Indirizzo di un valore HANDLE che riceve l'handle di associazione. Per chiudere questo handle, passarlo alla funzione DsUnBind .
Valore restituito
Restituisce ERROR_SUCCESS se il codice di errore di Windows o RPC ha esito positivo in caso contrario. Di seguito sono riportati i codici di errore più comuni.
Commenti
Il comportamento della funzione DsBind è determinato dal contenuto dei parametri DomainControllerName e DnsDomainName . Nell'elenco seguente viene descritto il comportamento di questa funzione in base al contenuto di questi parametri.
| DomainControllerName | DnsDomainName | Descrizione |
|---|---|---|
| NULL | NULL | DsBind tenterà di eseguire l'associazione a un server di catalogo globale nella foresta del computer locale. |
| (value) | NULL | DsBind tenterà di eseguire l'associazione al controller di dominio specificato dal parametro DomainControllerName . |
| NULL | (value) | DsBind tenterà di eseguire il binding a qualsiasi controller di dominio nel dominio specificato dal parametro DnsDomainName . |
| (valore) | (value) | Il parametro DomainControllerName ha la precedenza. DsBind tenterà di eseguire l'associazione al controller di dominio specificato dal parametro DomainControllerName . |
Nota
L'intestazione ntdsapi.h definisce DsBind 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | ntdsapi.h |
| Libreria | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Vedi anche
Funzioni di gestione del controller di dominio e della replica