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 を使用します。