共用方式為

credFindBestCredentialA 函式 (wincred.h)

  • 發行項

CredFindBestCredential 函式會搜尋認證管理 (CredMan) 資料庫，以取得與目前登入會話相關聯的一組泛型認證，且最符合指定的目標資源。

語法

BOOL CredFindBestCredentialA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

參數

[in] TargetName

Null 終止字串的指標，其中包含要尋找認證的目標資源名稱。

[in] Type

要搜尋的認證類型。 目前，此函式僅支援 CRED_TYPE_GENERIC。

[in] Flags

保留的。

[out] Credential

指定此函式所尋找之認證集之 CREDENTIAL 結構的指標位址。

當您完成使用此結構時，請呼叫 CredFree 函式來釋放它。

傳回值

如果函式成功，則會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

注意

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

規格需求

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