次の方法で共有

CredRenameA 関数 (wincred.h)

  • [アーティクル]

[CredRename はサポートされなくなりました。 Windows Vista 以降では、CredRename の呼び出しは常にERROR_NOT_SUPPORTEDを返します。

CredRename 関数は、ユーザーの資格情報セット内の資格情報の名前を変更します。 使用される資格情報セットは、現在のトークンのログオン セッションに関連付けられている資格情報セットです。 トークンは、ユーザーの SID を無効にしてはなりません。

構文

BOOL CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR NewTargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

パラメーター

[in] OldTargetName

名前を変更する資格情報の現在の名前を含む null で終わる文字列へのポインター。

[in] NewTargetName

資格情報の新しい名前を含む null で終わる文字列へのポインター。

[in] Type

名前を変更する資格情報の種類。 CRED_TYPE_* 定義のいずれかである必要があります。

[in] Flags

関数の操作を制御するためのフラグ。 現在予約されており、0 である必要があります。

戻り値

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

  • ERROR_NOT_FOUND

    指定した OldTargetNameを持つ資格情報がありません。

  • ERROR_ALREADY_EXISTS

    既に資格情報または種類 種類 があり、NewTargetName名前が付けられています。

  • ERROR_NO_SUCH_LOGON_SESSION

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

  • ERROR_INVALID_FLAGS

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

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wincred.h
ライブラリ Advapi32.lib
DLL Advapi32.dll