CredDeleteW 関数 (wincred.h)

  • [アーティクル]

CredDelete 関数は、ユーザーの資格情報セットから資格情報を削除します。 使用される資格情報セットは、現在のトークンのログオン セッションに関連付けられている資格情報セットです。 トークンでユーザーの SID が無効にされていない必要があります。

構文

BOOL CredDeleteW(
  [in] LPCWSTR 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

予約済みで、0 である必要があります。

戻り値

関数は、成功した場合は TRUE 、失敗した場合は FALSE を 返します。 GetLastError 関数を呼び出して、より具体的な状態コードを取得できます。 次の状態コードを返すことができます。

  • ERROR_NOT_FOUND

    指定された TargetName を持つ資格情報がありません。

  • ERROR_NO_SUCH_LOGON_SESSION

    ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。

  • ERROR_INVALID_FLAGS

    無効なフラグが Flags パラメーターに指定されました。

解説

注意

wincred.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CredDelete を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー wincred.h
Library Advapi32.lib
[DLL] Advapi32.dll