Funzione DsBindA (ntdsapi.h)

Articolo
08/25/2023

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"

Questo parametro può essere NULL. Per altre informazioni, vedere la sezione Osservazioni.

[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