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 che contiene 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. Uno dei due tipi di nome può, facoltativamente, essere preceduto 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 Osservazioni.
[out] phDS
Indirizzo di un HANDLE valore che riceve l'handle di associazione. Per chiudere questo handle, passarlo alla funzione DsUnBind
Valore restituito
Restituisce ERROR_SUCCESS in caso di esito positivo o di un codice di errore Windows o RPC in caso contrario. Di seguito sono riportati i codici di errore più comuni.
Osservazioni
Il comportamento della funzione DsBind
| DomainControllerName | DnsDomainName | Descrizione |
|---|---|---|
| NULL | NULL | DsBind tenterà di eseguire l'associazione a un server di catalogo globale nella foresta del computer locale. |
| (valore) | NULL |
|
| NULL | (valore) | DsBind tenterà di eseguire il binding a qualsiasi controller di dominio nel dominio specificato da parametro DnsDomainName. |
| (valore) | (valore) |
Il 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 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 |
ntdsapi.h |
| libreria |
Ntdsapi.lib |
| dll | Ntdsapi.dll |