PathCchRemoveExtension 関数 (pathcch.h)

  • [アーティクル]

パスが存在する場合は、パスからファイル名拡張子を削除します。

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

メモこの関数は、バッファー オーバーランの可能性を防ぐために PathRemoveExtension の代わりに使用する必要があります。

構文

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

パラメーター

[in, out] pszPath

パス文字列へのポインター。 この関数が正常に返されると、文字列には、拡張子が削除されたパスが含まれます。 拡張子が見つからなかった場合、文字列は変更されません。

[in] cchPath

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

戻り値

この関数は、関数が成功した場合は S_OK 、拡張機能が見つからない場合は S_FALSE 、それ以外の場合はエラー コードを返します。

要件

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