PathCchAddBackslashEx 関数 (pathcch.h)

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

この関数は PathCchAddBackslash とは異なり、文字列の新しい末尾へのポインターを返し、バッファーに残っている未使用の文字の数を報告できる点で異なります。

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

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

構文

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

パラメーター

[in, out] pszPath

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

[in] cchPath

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

[out, optional] ppszEnd

この関数が正常に返されるときに、文字列の末尾にある終端の null 文字へのポインターのアドレスを受け取る値。

[out, optional] pcchRemaining

この関数が正常に返されるときに、終端の null 文字を含む、宛先バッファー内の未使用の文字の数に設定される値へのポインター。

戻り値

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

要件

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

こちらもご覧ください

PathCchAddBackslash