CredReadA 函式 (wincred.h)

CredRead 函式會從用戶的認證集讀取認證。使用的認證集是與目前令牌登入會話相關聯的認證集。令牌不得停用使用者的 SID。

語法

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

[in] TargetName

Null 終止字串的指標，其中包含要讀取之認證的名稱。

[in] Type

要讀取的認證類型。類型必須是其中一個CRED_TYPE_* 定義的類型。

[in] Flags

目前保留且必須是零。

[out] Credential

單一配置區塊緩衝區的指標，以傳回認證。緩衝區內所包含的任何指標都是這個單一配置區塊中位置的指標。呼叫 CredFree，必須釋放單一傳回的緩衝區。

函式會在成功時傳回 TRUE ，並在失敗時傳回 FALSE 。您可以呼叫 GetLastError 函式，以取得更具體的狀態代碼。可以傳回下列狀態代碼：

如果 Credential 參數所指定 CREDENTIAL 結構的 Type 成員值CRED_TYPE_DOMAIN_EXTENDED，則必須在目標名稱中指定命名空間。此函式只能傳回指定類型的一個認證。

注意

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