SHGetSpecialFolderPathW 関数 (shlobj_core.h)
[SHGetSpecialFolderPath はサポートされていません。 代わりに、SHGetFolderPath.] を使用します。
CSIDLで識別される特殊なフォルダーのパスを取得します。
構文
BOOL SHGetSpecialFolderPathW(
HWND hwnd,
[out] LPWSTR pszPath,
[in] int csidl,
[in] BOOL fCreate
);
パラメーター
hwnd
型: HWND
引っ込み思案。
[out] pszPath
型: LPTSTR
指定したフォルダーのドライブとパスを受け取る null で終わる文字列へのポインター。 このバッファーのサイズは、少なくともMAX_PATH文字にする必要があります。
[in] csidl
型: int
目的のフォルダーを識別する CSIDL。 仮想フォルダーが指定されている場合、この関数は失敗します。
[in] fCreate
型: BOOL
フォルダーがまだ存在しない場合に作成するかどうかを示します。 この値が 0 以外の場合、フォルダーが作成されます。 この値が 0 の場合、フォルダーは作成されません。
戻り値
型: BOOL
成功した場合は TRUE を
備考
この関数を使用できるようにするには、Microsoft Internet Explorer 4.0 デスクトップ更新プログラムをインストールする必要があります。
手記
shlobj_core.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHGetSpecialFolderPath を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | shlobj_core.h (Shlobj.h、Shlobj_core.h を含む) |
ライブラリ | Shell32.lib |
DLL | Shell32.dll (バージョン 4.71 以降) |