SHCreateDirectory 関数 (shlobj_core.h)

  • [アーティクル]

[SHCreateDirectory は、要件セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

新しいファイル システム フォルダーを作成します。

構文

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

パラメーター

[in, optional] hwnd

型: HWND

親ウィンドウのハンドル。 ユーザー インターフェイスが表示されない場合は、このパラメーターを NULL に設定できます。

[in] pszPath

種類: PCWSTR

ディレクトリの完全修飾パスを含む null で終わる Unicode 文字列へのポインター。 この文字列には、終端の null 文字を含め、MAX_PATH文字以下にする必要があります。

戻り値

型: int

成功した場合 は、ERROR_SUCCESS を返します。 操作が失敗した場合は、ここに記載されているものも含め、他のエラー コードを返すことができます。 特に一覧にない値については、「 システム エラー コード」を参照してください。

リターン コード 説明
ERROR_BAD_PATHNAME
 pszPath パラメーターが相対パスに設定されました。
ERROR_FILENAME_EXCED_RANGE
 pszPath が指すパスが長すぎます。
ERROR_FILE_EXISTS
 ディレクトリが存在します。
ERROR_ALREADY_EXISTS
 ディレクトリが存在します。
ERROR_CANCELLED
 ユーザーが操作を取り消しました。

解説

この関数は、 pszPath によって完全修飾パスが指定されたファイル システム フォルダーを作成します。 中間フォルダーが 1 つ以上存在しない場合は、そのフォルダーが作成されます。

新しいフォルダーにセキュリティ属性を設定するには、 SHCreateDirectoryEx を使用します。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h を含む)
Library Shell32.lib
[DLL] Shell32.dll (バージョン 5.0 以降)

関連項目

SHCreateDirectoryEx