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 または次の値を指定できます。
| 価値 | 意味 |
|---|---|
|
デスクトップ上の他のアカウントで実行されているプロセスで、このプロセスにフックを設定できるようにします。 |
[in] dwDesiredAccess
デスクトップへのアクセス。 値の一覧については、「デスクトップ セキュリティとアクセス権の」を参照してください。
内部 CreateDesktop はハンドルを使用してウィンドウを作成するため、このパラメーターには DESKTOP_CREATEWINDOW アクセス権を含める必要があります。
[in, optional] lpsa
返されたハンドルを子プロセスによって継承できるかどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインター。 lpsa
構造体の lpSecurityDescriptor メンバーは、新しいデスクトップのセキュリティ記述子を指定します。 このパラメーターが NULL の場合、デスクトップは親ウィンドウ ステーションからセキュリティ記述子を継承します。
戻り値
関数が成功した場合、戻り値は新しく作成されたデスクトップへのハンドルです。 指定したデスクトップが既に存在する場合、関数は成功し、既存のデスクトップにハンドルを返します。 ハンドルの使用が完了したら、CloseDesktop 関数を呼び出して閉じます。
関数が失敗した場合、戻り値は NULL
備考
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" 値は、すべてのデスクトップに共通する共有ヒープのサイズ (KB 単位) です。
- 2 番目の "SharedSection" 値は、対話型ウィンドウ ステーション WinSta0 で作成された各デスクトップに必要なデスクトップ ヒープのサイズ (KB 単位) です。
- 3 番目の "SharedSection" 値は、非対話型ウィンドウ ステーションで作成された各デスクトップに必要なデスクトップ ヒープのサイズ (KB 単位) です。
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CreateDesktop を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
| API セットの | ext-ms-win-ntuser-windowstation-l1-1-0 (Windows 8 で導入) |
関連項目
CreateDesktopEx の
SetProcessWindowStation の