PathCchStripToRoot 関数 (pathcch.h)

ルート情報を除き、パス内のすべてのファイル要素とディレクトリ要素を削除します。

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

構文

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

パラメーター

[in, out] pszPath

パス文字列へのポインター。 この関数が正常に返されると、この文字列には、そのパスから取得されたルート情報のみが含まれます。

[in] cchPath

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

戻り値

この関数は、パスが切り捨てられた場合は S_OK を返 します。パス が既にルートであった場合は S_FALSE、 HRESULT エラー コードは返されます。

注釈

この関数の効果の例を次に示します。

要件