CredDeleteA 函式 （wincred.h）

CredDelete 函式會從使用者的認證集刪除認證。 使用的認證集是與目前令牌之登入會話相關聯的認證集。 令牌不得停用使用者的 SID。

語法

BOOL CredDeleteA(
  [in] LPCSTR TargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

參數

[in] TargetName

包含要刪除之認證名稱之 Null 終止字串的指標。

[in] Type

要刪除的認證類型。 必須是其中一個CRED_TYPE_* 定義的類型。 如需已定義型別的清單，請參閱 CREDENTIAL 結構的 Type 成員。

如果此參數的值是 CRED_TYPE_DOMAIN_EXTENDED，則當相同目標有多個認證時，此函式可以刪除指定使用者名稱的認證。 TargetName 參數的值必須將使用者名稱指定為 Target|UserName。

[in] Flags

保留且必須是零。

傳回值

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

• ERROR_NOT_FOUND

  沒有指定 TargetName的認證。

• ERROR_NO_SUCH_LOGON_SESSION

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

• ERROR_INVALID_FLAGS

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

言論

要求