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 函式 ，以取得更具體的狀態代碼。 可以傳回下列狀態代碼：

• ERROR_NOT_FOUND

  指定 TargetName不存在認證。

• ERROR_NO_SUCH_LOGON_SESSION

  登入會話不存在，或沒有與此登入會話相關聯的認證集。 網路登入會話沒有相關聯的認證集。

• ERROR_INVALID_FLAGS

  Flags 參數指定了無效的旗標。

言論

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

要求