PathAllocCanonicalize 関数 (pathcch.h)
パス文字列を正規形式に変換します。
この関数は、ヒープで結果を返す点で 、PathCchCanonicalize および PathCchCanonicalizeEx とは異なります。 つまり、呼び出し元は返される文字列のサイズを宣言する必要がないため、スタックの使用が減ります。
この関数は PathCanonicalize とは異なり、"\"、"\?" および "\?\UNC" プレフィックスを持つパスを受け入れます。
構文
WINPATHCCHAPI HRESULT PathAllocCanonicalize(
[in] PCWSTR pszPathIn,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
パラメーター
[in] pszPathIn
元の文字列を含むバッファーへのポインター。 この値を NULL にすることはできません。
[in] dwFlags
次のフラグの 1 つまたは複数:
[out] ppszPathOut
この関数が正常に返されたときに正規化されたパス文字列を受け取るバッファーへのポインターのアドレス。 このリソースが不要になったときに LocalFree 関数を呼び出すことで、このリソースを解放するのは呼び出し元の責任です。 この値を NULL にすることはできません。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
この関数は、次の代替パス形式をサポートしています。
- \\?\
- \\。\\Unc\
- \\?\Volume{guid}\
この関数は、スラッシュ (/) をバック スラッシュ (\) に変換しません。 信頼されていない入力では、この関数自体を使用して、パスをサブパスまたは ID の他のパスと比較できるフォームに変換することはできません。 その機能を必要とする呼び出し元は、この関数を使用する前にバック スラッシュに変換する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | pathcch.h |
Library | Pathcch.lib |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示