共用方式為

CredUIConfirmCredentialsW 函式 （wincred.h）

  • 發行項

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

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

語法

CREDUIAPI DWORD CredUIConfirmCredentialsW(
  [in] PCWSTR pszTargetName,
  [in] BOOL   bConfirm
);

參數

[in] pszTargetName

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

[in] bConfirm

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

傳回值

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

傳回碼 描述
NO_ERROR - （零）
 確認作業成功。
ERROR_NOT_FOUND
 確認等候清單上找不到主體認證。
ERROR_INVALID_PARAMETER
 嘗試確認等候的認證失敗，因為認證包含無效或不一致的數據。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wincred.h
連結庫 Credui.lib
DLL Credui.dll