Funzione CredUIPromptForWindowsCredentialsW (wincred.h)

La funzione CredUIPromptForWindowsCredentials crea e visualizza una finestra di dialogo configurabile che consente agli utenti di fornire informazioni sulle credenziali usando qualsiasi provider di credenziali installato nel computer locale.

Sintassi

CREDUIAPI DWORD CredUIPromptForWindowsCredentialsW(
  [in, optional]      PCREDUI_INFOW pUiInfo,
  [in]                DWORD         dwAuthError,
  [in, out]           ULONG         *pulAuthPackage,
  [in, optional]      LPCVOID       pvInAuthBuffer,
  [in]                ULONG         ulInAuthBufferSize,
  [out]               LPVOID        *ppvOutAuthBuffer,
  [out]               ULONG         *pulOutAuthBufferSize,
  [in, out, optional] BOOL          *pfSave,
  [in]                DWORD         dwFlags
);

Parametri

[in, optional] pUiInfo

Puntatore a una struttura CREDUI_INFO che contiene informazioni per personalizzare l'aspetto della finestra di dialogo visualizzata da questa funzione.

Se il membro hwndParent della struttura CREDUI_INFO non è NULL, questa funzione visualizza una finestra di dialogo modale centrata sulla finestra padre.

Se il membro hwndParent della struttura CREDUI_INFO è NULL, la funzione visualizza una finestra di dialogo centrata sullo schermo.

Questa funzione ignora il membro hbmBanner della struttura CREDUI_INFO .

[in] dwAuthError

Codice di errore di Windows, definito in Winerror.h, visualizzato nella finestra di dialogo. Se le credenziali raccolte in precedenza non sono valide, il chiamante usa questo parametro per passare il messaggio di errore dall'API che ha raccolto le credenziali (ad esempio, Winlogon) a questa funzione. Il messaggio di errore corrispondente viene formattato e visualizzato nella finestra di dialogo. Impostare il valore di questo parametro su zero per non visualizzare alcun messaggio di errore.

[in, out] pulAuthPackage

In input, il valore di questo parametro viene usato per specificare il pacchetto di autenticazione per cui vengono serializzate le credenziali nel buffer pvInAuthBuffer . Se il valore di pvInAuthBuffer è NULL e il flag CREDUIWIN_AUTHPACKAGE_ONLY viene impostato nel parametro dwFlags , verranno enumerati solo i provider di credenziali in grado di serializzare le credenziali per il pacchetto di autenticazione specificato.

Per ottenere il valore appropriato da usare per questo parametro nell'input, chiamare la funzione LsaLookupAuthenticationPackage e usare il valore del parametro AuthenticationPackage di tale funzione.

Nell'output questo parametro specifica il pacchetto di autenticazione per il quale vengono serializzate le credenziali nel buffer ppvOutAuthBuffer .

[in, optional] pvInAuthBuffer

Puntatore a un BLOB di credenziali usato per popolare i campi delle credenziali nella finestra di dialogo. Impostare il valore di questo parametro su NULL per lasciare vuoti i campi delle credenziali.

[in] ulInAuthBufferSize

Dimensioni, in byte, del buffer pvInAuthBuffer .

[out] ppvOutAuthBuffer

L'indirizzo di un puntatore che, nell'output, specifica il BLOB delle credenziali. Per le credenziali Kerberos, NTLM o Negotiate, chiamare la funzione CredUnPackAuthenticationBuffer per convertire questo BLOB in rappresentazioni di stringa delle credenziali.

Al termine dell'uso del BLOB delle credenziali, cancellarlo dalla memoria chiamando la funzione SecureZeroMemory e liberandola chiamando la funzione CoTaskMemFree .

[out] pulOutAuthBufferSize

Dimensioni, in byte, del buffer ppvOutAuthBuffer .

[in, out, optional] pfSave

Puntatore a un valore booleano che, all'input, specifica se la casella di controllo Salva è selezionata nella finestra di dialogo visualizzata da questa funzione. Nell'output, il valore di questo parametro specifica se la casella di controllo Salva è stata selezionata quando l'utente fa clic sul pulsante Invia nella finestra di dialogo. Impostare questo parametro su NULL per ignorare la casella di controllo Salva .

Questo parametro viene ignorato se il flag CREDUIWIN_CHECKBOX non è impostato nel parametro dwFlags .

[in] dwFlags

Valore che specifica il comportamento per questa funzione. Questo valore può essere una combinazione OR bit per bit di uno o più dei valori seguenti.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce ERROR_SUCCESS. Se la funzione viene annullata dall'utente, restituisce ERROR_CANCELLED. Qualsiasi altro valore restituito indica che la funzione non è stata caricata.

Commenti

Questa funzione non salva le credenziali.

Le applicazioni che usano SSPI per autenticare gli utenti non devono chiamare questa funzione. Chiamare invece SspiPromptForCredentials.

Requisiti