PathCchRenameExtension 関数 (pathcch.h)

  • [アーティクル]

パス文字列の末尾にあるファイル名の拡張子を新しい拡張子に置き換えます。 パス文字列が拡張子で終わらない場合は、新しい拡張機能が追加されます。

この関数は PathRenameExtension とは異なり、"\"、"\?"、"\?\UNC" プレフィックスを持つパスを受け入れます。

メモ バッファー オーバーランが発生しないようにするには、 PathRenameExtension の代わりにこの関数を使用する必要があります。

構文

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

パラメーター

[in, out] pszPath

パス文字列へのポインター。 この関数が正常に返されると、この値は同じ文字列を指しますが、名前が変更されたか、拡張子が追加されています。

[in] cchPath

pszPath が指すバッファーのサイズ (文字単位)。

[in] pszExt

新しい拡張文字列へのポインター。 先頭の '.' 文字は省略可能です。 空の文字列 ("") の場合、パス文字列内の既存の拡張子はすべて削除されます。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー pathcch.h
Library Pathcch.lib