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 參數指定無效 的旗標 。

備註

注意

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

規格需求

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