Funzione CredUIConfirmCredentialsA (wincred.h)

Articolo
03/03/2024

La funzione CredUIConfirmCredentials viene chiamata dopo CredUIPromptForCredentials o CredUICmdLinePromptForCredentials per confermare la validità delle credenziali raccolte. CredUIConfirmCredentials deve essere chiamato se il flag CREDUI_FLAGS_EXPECT_CONFIRMATION è stato passato alla funzione "prompt", CredUIPromptForCredentials o CredUICmdLinePromptForCredentials e la funzione "prompt" ha restituito NO_ERROR.

Dopo aver chiamato la funzione "prompt" e prima di chiamare CredUIConfirmCredentials, il chiamante deve determinare se le credenziali sono effettivamente valide usando le credenziali per accedere alla risorsa specificata da pszTargetName. I risultati del test di convalida vengono passati a CredUIConfirmCredentials nel parametro bConfirm .

Sintassi

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR pszTargetName,
  [in] BOOL  bConfirm
);

Parametri

[in] pszTargetName

Puntatore a una stringa con terminazione Null che contiene il nome della destinazione per le credenziali, in genere un nome di dominio o applicazione server. Deve essere lo stesso valore passato a pszTargetName a CredUIPromptForCredentials o CredUICmdLinePromptForCredentials

[in] bConfirm

Specifica se le credenziali restituite dalla funzione prompt sono valide. Se TRUE, le credenziali vengono archiviate nel gestore credenziali come definito da CredUIPromptForCredentials o CredUICmdLinePromptForCredentials. Se FALSE, le credenziali non vengono archiviate e vengono ripulite varie parti di memoria.

Valore restituito

Lo stato dell'operazione viene restituito. Il chiamante può controllare questo stato per determinare se l'operazione di conferma delle credenziali ha avuto esito positivo. La maggior parte delle applicazioni ignora questo codice di stato perché la connessione dell'applicazione alla risorsa è già stata eseguita. L'operazione può avere esito negativo perché la credenziale non è stata trovata nell'elenco delle credenziali in attesa di conferma oppure perché il tentativo di scrivere o eliminare le credenziali non è riuscito. L'errore di trovare le credenziali nell'elenco può verificarsi perché le credenziali non sono mai state accodate o in seguito a un numero eccessivo di credenziali in coda. È possibile accodare fino a cinque credenziali prima che quelle precedenti vengano eliminate man mano che quelle più recenti vengono accodate.

Codice restituito	Descrizione
NO_ERROR - (zero)	Confermare che l'operazione è riuscita.
ERROR_NOT_FOUND	Impossibile trovare la credenziale oggetto nell'elenco di attesa di conferma.
ERROR_INVALID_PARAMETER	Tentativo di confermare una credenziale in attesa non riuscito perché le credenziali contengono dati non validi o incoerenti.

Commenti

Nota

L'intestazione wincred.h definisce CredUIConfirmCredentials 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 XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincred.h
Libreria	Credui.lib
DLL	Credui.dll

Condividi tramite