SHPathPrepareForWriteW

パスが存在するかどうかをチェックする。(Unicode)

SHPathPrepareForWriteW hwnd, punkEnableModless, pszPath, dwFlags

hwnd : [intptr] 型: HWND 作成する必要のあるユーザーインターフェイスウィンドウに使用される親ウィンドウを指定するウィンドウへのハンドル。NULL に設定すると、ユーザーインターフェイスウィンドウは作成されない。
punkEnableModless : [var] 型: IUnknown* EnableModeless メソッドを実装する IOleInPlaceActiveObject オブジェクトを指定する IUnknown インターフェイスへのポインター。
pszPath : [wstr] 型: LPCTSTR 書き込みに有効かを検証するパスを指定する、最大長 MAX_PATH の null 終端文字列へのポインター。これは UNC またはファイルドライブのパスでもよい。
dwFlags : [int] 型: DWORD

(プラグイン / モジュール : shell32.dll)

解説

パスが存在するかどうかをチェックする。(Unicode)

[戻り値]
型: HRESULT パスが利用可能な場合は S_OK を、それ以外の場合はエラーコードを返す。S_OK
の戻り値はメディアが書き込み可能であることを意味するわけではなく、単にパスが利用可能であることを意味することに注意。

[備考]
この関数の主な用途は、プログラムがパスを使用する前にチェックし、ユーザーに促す必要なユーザーインターフェイスを表示することである。たとえば
A: ドライブのディスクが入っていない場合、ユーザーにディスクを挿入するよう促すウィンドウが表示される。
> [!NOTE] > shlobj_core.h ヘッダーは SHPathPrepareForWrite を、UNICODE
プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスとそうでないコードを混在して使用すると、コンパイルや実行時のエラーにつながる不一致が発生する場合がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報