Funzione DsMakePasswordCredentialsA (ntdsapi.h)

Articolo
02/29/2024

La funzione DsMakePasswordCredentials costruisce un handle di credenziali adatto per l'uso con la funzione DsBindWithCred .

Sintassi

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

Parametri

[in] User

Puntatore a una stringa con terminazione Null contenente il nome utente da usare per le credenziali.

[in] Domain

Puntatore a una stringa con terminazione Null contenente il dominio di cui l'utente è membro.

[in] Password

Puntatore a una stringa con terminazione Null contenente la password da usare per le credenziali.

[out] pAuthIdentity

Puntatore a un valore RPC_AUTH_IDENTITY_HANDLE che riceve l'handle delle credenziali. Questo handle viene usato in una chiamata successiva a DsBindWithCred. Questo handle deve essere liberato con la funzione DsFreePasswordCredentials quando non è più necessario.

Valore restituito

Restituisce un codice di errore di Windows, incluso quanto segue.

Commenti

Se User, Domain e Password sono tutti NULL, viene creato un handle di credenziali predefinito null. In caso contrario, l'utente deve essere presente. Il parametro Domain può essere NULL quando User è completo, ad esempio un utente in formato UPN; ad esempio "someone@fabrikam.com".

Quando l'handle restituito in pAuthIdentity viene passato a DsBindWithCred, È necessario chiamare DsUnBind prima di liberare l'handle con DsFreePasswordCredentials. La sequenza normale è:

Chiamare DsMakePasswordCredentials per ottenere l'handle delle credenziali.
Chiamare DsBindWithCred e passare l'handle delle credenziali.
Chiamare DsUnbind quando l'associazione non è più necessaria.
Chiamare DsFreePasswordCredentials per liberare l'handle delle credenziali.

Nota

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