credUIConfirmCredentialsA 函式 (wincred.h)

  • 發行項

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

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

語法

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

參數

[in] pszTargetName

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

[in] bConfirm

指定從提示函式傳回的認證是否有效。 如果為 TRUE，認證會儲存在認證管理員中，如 CredUIPromptForCredentials 或 CredUICmdLinePromptForCredentials 所定義。 如果為 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