Funzione CredPackAuthenticationBufferA (wincred.h)

La funzione credPackAuthenticationBuffer converte un nome utente e una password stringa in un buffer di autenticazione.

A partire da Windows 8 e Windows Server 2012, la funzione CredPackAuthenticationBuffer converte una credenziale di identità in un buffer di autenticazione, ovvero una struttura SEC_WINNT_AUTH_IDENTITY_EX2. Questo buffer può essere passato a LsaLogonUser, AcquireCredentialsHandleo altre interfacce del provider di identità.

Sintassi

CREDUIAPI BOOL CredPackAuthenticationBufferA(
  [in]      DWORD dwFlags,
  [in]      LPSTR pszUserName,
  [in]      LPSTR pszPassword,
  [out]     PBYTE pPackedCredentials,
  [in, out] DWORD *pcbPackedCredentials
);

Parametri

[in] dwFlags

Specifica la modalità di creazione del pacchetto delle credenziali. Può trattarsi di una combinazione dei flag seguenti.

[in] pszUserName

Puntatore a una stringa con terminazione Null che specifica il nome utente da convertire. Per gli utenti di dominio, la stringa deve essere nel formato seguente:

DomainName\UserName

Per le identità online, se la credenziale è una password in testo non crittografato, il formato del nome utente è ProviderName\UserName. Se la credenziale è una struttura di SEC_WINNT_AUTH_IDENTITY_EX2, il nome utente è una stringa codificata che corrisponde all'output del parametro UserName di una chiamata di funzione a SspiEncodeAuthIdentityAsStrings.

Per o credenziali del certificato, il nome utente è una stringa codificata che rappresenta l'output di una chiamata di funzione a CredMarshalCredential con l'opzione CertCredential.

Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: le identità Online non sono supportate.

[in] pszPassword

Puntatore a una stringa con terminazione Null che specifica la password da convertire.

Per SEC_WINNT_AUTH_IDENTITY_EX2 credenziali, la password è una stringa codificata che si trova nel ppszPackedCredentialsString output di una chiamata di funzione a SspiEncodeAuthIdentityAsStrings.

Per credenziali di smart card, si tratta del PIN smart card.

Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: le identità Online non sono supportate.

[out] pPackedCredentials

Puntatore a una matrice di byte che, nell'output, riceve il buffer di autenticazione compresso. Questo parametro può essere NULL per ricevere le dimensioni del buffer necessarie nel parametro pcbPackedCredential s.

[in, out] pcbPackedCredentials

Puntatore a un valore DWORD che specifica le dimensioni, in byte, del buffer pPackedCredentials . In caso di output, se il buffer non è di dimensioni sufficienti, specifica le dimensioni richieste, in byte, del buffer pPackedCredentials .

Valore restituito

TRUE se la funzione ha esito positivo; in caso contrario, FALSE.

Per informazioni estese sull'errore, chiamare la funzione GetLastError , che può restituire i codici di errore seguenti.

Osservazioni

Fabbisogno