CreateDesktopExW

指定したヒープを持つ新しいデスクトップを作成し、呼び出し元プロセスの現在のウィンドウステーションに関連付け、呼び出し元スレッドに割り当てる。(Unicode)

CreateDesktopExW lpszDesktop, lpszDevice, pDevmode, dwFlags, dwDesiredAccess, lpsa, ulHeapSize, pvoid

lpszDesktop : [wstr] 作成するデスクトップの名前。デスクトップ名は大文字小文字を区別せず、バックスラッシュ文字 (\\) を含めることはできない。
lpszDevice : [wstr] 予約されており、NULL でなければならない。
pDevmode : [var] 予約されており、NULL でなければならない。
dwFlags : [int] このパラメータは 0 または次の値を指定できる。
dwDesiredAccess : [int] デスクトップへの要求アクセス。値の一覧については Desktop Security and Access Rights を参照。
lpsa : [var] 返されるハンドルが子プロセスに継承可能かどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインタ。lpsa が NULL の場合、ハンドルは継承されない。
ulHeapSize : [int] デスクトップヒープのサイズ (キロバイト単位)。
pvoid : [intptr] 予約されており、NULL でなければならない。

(プラグイン / モジュール : user32.dll)

解説

指定したヒープを持つ新しいデスクトップを作成し、呼び出し元プロセスの現在のウィンドウステーションに関連付け、呼び出し元スレッドに割り当てる。(Unicode)

[戻り値]

関数が成功した場合、戻り値は新しく作成されたデスクトップへのハンドル。指定されたデスクトップが既に存在する場合、関数は成功し、既存のデスクトップへのハンドルを返す。ハンドルの使用が終わったら
CloseDesktop 関数を呼んで閉じる。関数が失敗した場合、戻り値は NULL。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
dwDesiredAccess に READ_CONTROL、WRITE_DAC、または WRITE_OWNER
の標準アクセス権を指定する場合、DESKTOP_READOBJECTS と DESKTOP_WRITEOBJECTS
アクセス権も要求しなければならない。作成可能なデスクトップ数はシステムデスクトップヒープのサイズによって制限される。デスクトップオブジェクトはリソースを格納するためにこのヒープを使用する。デスクトップヒープサイズを増やすか、対話的ウィンドウステーション内の各デスクトップに予約される既定ヒープを減らすことで、作成可能なデスクトップ数を増やせる。この値は次のレジストリ値の
SharedSection サブ文字列で指定される:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session
Manager\SubSystems\Windows。このレジストリ値の既定データは次のとおり:

情報