CreateDesktopA 関数 (winuser.h)

  • [アーティクル]

新しいデスクトップを作成し、それを呼び出し元プロセスの現在のウィンドウ ステーションに関連付け、呼び出し元スレッドに割り当てます。 呼び出し元プロセスには、プロセス作成時にシステムによって割り当てられるか、 SetProcessWindowStation 関数によって設定される、関連付けられたウィンドウ ステーションが必要です。

デスクトップのヒープのサイズを指定するには、 CreateDesktopEx 関数を使用します。

構文

HDESK CreateDesktopA(
  [in]           LPCSTR                lpszDesktop,
                 LPCSTR                lpszDevice,
                 DEVMODEA              *pDevmode,
  [in]           DWORD                 dwFlags,
  [in]           ACCESS_MASK           dwDesiredAccess,
  [in, optional] LPSECURITY_ATTRIBUTES lpsa
);

パラメーター

[in] lpszDesktop

作成するデスクトップの名前。 デスクトップ名では大文字と小文字が区別されず、円記号 (\) を含めないようにすることができます。

lpszDevice

予約; は NULL である必要があります。

pDevmode

予約; は NULL である必要があります。

[in] dwFlags

このパラメーターには、0 または次の値を指定できます。

値 意味
DF_ALLOWOTHERACCOUNTHOOK
0x0001
 デスクトップ上の他のアカウントで実行されているプロセスで、このプロセスでフックを設定できるようにします。

[in] dwDesiredAccess

デスクトップへのアクセス。 値の一覧については、「 デスクトップ セキュリティとアクセス権」を参照してください。

内部的に CreateDesktop は ハンドルを使用してウィンドウを作成するため、このパラメーターには DESKTOP_CREATEWINDOW アクセス権を含める必要があります。

[in, optional] lpsa

返された ハンドルを子 プロセスによって継承できるかどうかを決定するSECURITY_ATTRIBUTES構造体へのポインター。 lpsa が NULL の場合、ハンドルを継承できません。

構造体の lpSecurityDescriptor メンバーは、新しいデスクトップのセキュリティ記述子を指定します。 このパラメーターが NULL の場合、デスクトップは、そのセキュリティ記述子を親ウィンドウ ステーションから継承します。

戻り値

関数が成功した場合、戻り値は新しく作成されたデスクトップへのハンドルです。 指定したデスクトップが既に存在する場合、関数は成功し、既存のデスクトップにハンドルを返します。 ハンドルの使用が完了したら、 CloseDesktop 関数を呼び出して閉じます。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

dwDesiredAccess パラメーターで標準アクセス権のREAD_CONTROL、WRITE_DAC、またはWRITE_OWNERを指定する場合は、DESKTOP_READOBJECTSとDESKTOP_WRITEOBJECTSアクセス権も要求する必要があります。

作成できるデスクトップの数は、システム デスクトップ ヒープのサイズ (48 MB) によって制限されます。 デスクトップ オブジェクトは、ヒープを使用してリソースを格納します。 対話型ウィンドウ ステーションの各デスクトップ用に予約されている既定のヒープを減らすことで、作成できるデスクトップの数を増やすことができます。 この値は、次のレジストリ値の "SharedSection" 部分文字列 で指定HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems\Windows。 このレジストリ値の既定のデータは次のとおりです。

"%SystemRoot%\system32\csrss.exe ObjectDirectory=\Windows SharedSection=1024,3072,512 Windows=On SubSystemType=Windows ServerDll=basesrv,1 ServerDll=winsrv:UserServerDllInitialization,3 ServerDll=winsrv:ConServerDllInitialization,2 ProfileControl=Off MaxRequestThreads=16"

"SharedSection" 部分文字列の値を次に示します。

  • 最初の "SharedSection" 値は、すべてのデスクトップに共通の共有ヒープのサイズ (キロバイト単位) です。
  • 2 番目の "SharedSection" 値は、対話型ウィンドウ ステーション WinSta0 で作成された各デスクトップに必要なデスクトップ ヒープのサイズ (キロバイト単位) です。
  • 3 番目の "SharedSection" 値は、非インターアクティブウィンドウ ステーションで作成された各デスクトップに必要なデスクトップ ヒープのサイズ (キロバイト単位) です。

注意

winuser.h ヘッダーは、CreateDesktop をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-windowstation-l1-1-0 (Windows 8で導入)

こちらもご覧ください

CloseDesktop

CreateDesktopEx

デスクトップ

SECURITY_ATTRIBUTES

SetProcessWindowStation

SwitchDesktop

ウィンドウ ステーションとデスクトップ関数