共用方式為


credUIConfirmCredentialsA 函式 (wincred.h)

CredUIConfirmCredentials 函式會在 CredUIPromptForCredentialsCredUICmdLinePromptForCredentials 之後呼叫,以確認所收集認證的有效性。 如果CREDUI_FLAGS_EXPECT_CONFIRMATION旗標傳遞至 「prompt」 函式、CredUIPromptForCredentialsCredUICmdLinePromptForCredentials,而且傳回 “prompt” 函式NO_ERROR,則必須呼叫 CredUIConfirmCredentials

呼叫 「prompt」 函式之後,以及在呼叫 CredUIConfirmCredentials 之前,呼叫端必須使用認證來存取 pszTargetName 所指定的資源,來判斷認證是否實際有效。 該驗證測試的結果會傳遞至 bConfirm 參數中的 CredUIConfirmCredentials

語法

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

參數

[in] pszTargetName

Null 終止字串的指標,其中包含認證的目標名稱,通常是網域或伺服器應用程式名稱。 此值必須與 pszTargetName 傳遞至 CredUIPromptForCredentialsCredUICmdLinePromptForCredentials 的值相同

[in] bConfirm

指定從提示函式傳回的認證是否有效。 如果為 TRUE,認證會儲存在認證管理員中,如 CredUIPromptForCredentialsCredUICmdLinePromptForCredentials 所定義。 如果為 FALSE,則不會儲存認證,而且會清除各種記憶體片段。

傳回值

傳回作業的狀態。 呼叫端可以檢查此狀態,以判斷認證確認作業是否成功。 大部分的應用程式都會忽略此狀態代碼,因為應用程式的資源連線已經完成。 作業可能會失敗,因為在等候確認的認證清單中找不到認證,或嘗試寫入或刪除認證失敗。 找不到清單上的認證可能會因為認證從未排入佇列,或因為佇列太多認證而發生。 在舊認證被捨棄之前,最多可以排入五個認證,因為較新的認證會排入佇列。

傳回碼 Description
NO_ERROR - (零)
確認作業成功。
ERROR_NOT_FOUND
在確認等候清單中找不到主體認證。
ERROR_INVALID_PARAMETER
嘗試確認等候的認證失敗,因為認證包含無效或不一致的數據。

備註

注意

wincred.h 標頭會根據 UNICODE 預處理器常數的定義,將 CredUIConfirmCredentials 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 wincred.h
程式庫 Credui.lib
Dll Credui.dll