Funzione DsMakePasswordCredentialsA (ntdsapi.h)

  • Articolo

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 è:

  1. Chiamare DsMakePasswordCredentials per ottenere l'handle delle credenziali.
  2. Chiamare DsBindWithCred e passare l'handle delle credenziali.
  3. Chiamare DsUnbind quando l'associazione non è più necessaria.
  4. 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

Vedi anche

Funzioni di gestione del controller di dominio e della replica

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE