PathCchFindExtension 関数 (pathcch.h)

  • [アーティクル]

パスを検索して、".exe" や ".ini" などのファイル名拡張子を検索します。 この関数は、特定の拡張機能を検索しません。拡張機能の存在を検索します。

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

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

構文

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

パラメーター

[in] pszPath

検索するパスへのポインター。

[in] cchPath

pszPath が指すバッファーのサイズ (null ターミネータを含む文字)。

[out] ppszExt

この関数が正常に返されたときに、 pszPath 内の拡張機能の前にある "." 文字を指すポインターのアドレス。 拡張子が見つからない場合は、文字列の終端の null 文字を指します。

戻り値

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

要件

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