Funzione DsBindWithCredA (ntdsapi.h)

Articolo
08/25/2023

La funzione DsBindWithCred viene associata a un controller di dominio usando le credenziali specificate.

Sintassi

NTDSAPI DWORD DsBindWithCredA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [out]          HANDLE                   *phDS
);

Parametri

[in, optional] DomainControllerName

Puntatore a una stringa con terminazione Null contenente il nome DNS completo del dominio da associare. Per altre informazioni su questo parametro, vedere la descrizione domainControllerName nell'argomento DsBind .

[in, optional] DnsDomainName

Puntatore a una stringa con terminazione Null contenente il nome DNS completo del dominio a cui eseguire l'associazione. Per altre informazioni su questo parametro, vedere la descrizione dnsDomainName nell'argomento DsBind .

Questo parametro è necessario per proteggere un'autenticazione Kerberos.

[in, optional] AuthIdentity

Contiene un valore RPC_AUTH_IDENTITY_HANDLE che rappresenta le credenziali da utilizzare per l'associazione. The

La funzione DsMakePasswordCredentials viene usata per ottenere questo valore. Se questo parametro è NULL, vengono usate le credenziali del thread chiamante.

È necessario chiamare DsUnBind prima di liberare questo handle con la funzione DsFreePasswordCredentials.

[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

Nota

L'intestazione ntdsapi.h definisce DsBindWithCred 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