Funzione CredUIConfirmCredentialsA (wincred.h)

Articolo
11/20/2024

La funzione CredUIConfirmCredentials viene chiamata dopo CredUIPromptForCredentials o CredUICmdLinePromptForCredentialsper confermare la validità delle credenziali raccolte. CredUIConfirmCredentials deve essere chiamato se il flag CREDUI_FLAGS_EXPECT_CONFIRMATION è stato passato alla funzione "prompt", CredUIPromptForCredentials o CredUICmdLinePromptForCredentialse la funzione "prompt" restituita 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 un nullstringa con terminazione contenente il nome della destinazione per le credenziali, in genere un nome di dominio o di applicazione server. Deve essere lo stesso valore passato come 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 delle credenziali come definito da CredUIPromptForCredentials o CredUICmdLinePromptForCredentials. Se FALSE, le credenziali non vengono archiviate e vengono pulite varie parti di memoria.

Valore restituito

Viene restituito lo stato dell'operazione. Il chiamante può controllare questo stato per determinare se l'operazione di conferma della credenziale è riuscita. La maggior parte delle applicazioni ignora questo codice di stato perché la connessione dell'applicazione alla risorsa è già stata eseguita. L'operazione può non riuscire perché la credenziale non è stata trovata nell'elenco delle credenziali in attesa di conferma o 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 a causa di un numero eccessivo di credenziali in coda. È possibile accodare fino a cinque credenziali prima che quelle precedenti vengano rimosse man mano che vengono accodate quelle più recenti.

Codice restituito	Descrizione
NO_ERROR - (zero)	Confermare che l'operazione è riuscita.
ERROR_NOT_FOUND	Impossibile trovare le credenziali 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 non coerenti.

Osservazioni

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 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 XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincred.h
libreria	Credui.lib
dll	Credui.dll

Condividi tramite