Funzione DsMakePasswordCredentialsA (ntdsapi.h)

Articolo
11/20/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 che contiene 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ù necessaria.

Valore restituito

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

Osservazioni

Viene creato un handle di credenziali predefinito null se User, Domain e Password sono tutti NULL. In caso contrario, ' utente deve essere presente. Il parametro domain può essere null quando user è completo, ad esempio un utente in formato UPN; ad esempio "".

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 DsBindWithCrede 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 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

Vedere anche

controller di dominio e funzioni di gestione della replica

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE

Condividi tramite