PathCchAddBackslash 関数 (pathcch.h)

文字列の末尾に円記号を追加して、パスの正しい構文を作成します。ソースパスに末尾の円記号が既に含まれている場合、円記号は追加されません。

この関数は PathCchAddBackslashEx とは異なり、長さMAX_PATHの最終パスに制限されます。

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

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

構文

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

[in, out] pszPath

パス文字列へのポインター。この関数が正常に返されると、バッファーには、バックスラッシュが追加された文字列が含まれます。この値は NULL にしないでください。

[in] cchPath

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

この関数は、関数が成功した場合は S_OK を返し、パス文字列が既に円記号で終わる場合はS_FALSE、それ以外の場合はエラーコードを返します。

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