CreateDesktopW

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

CreateDesktopW lpszDesktop, lpszDevice, pDevmode, dwFlags, dwDesiredAccess, lpsa

lpszDesktop : [wstr] 作成するデスクトップの名前。デスクトップ名は大文字小文字を区別せず、バックスラッシュ文字 (\\) を含めることはできない。
lpszDevice : [wstr] 予約されており、NULL でなければならない。
pDevmode : [var] 予約されており、NULL でなければならない。
dwFlags : [int] このパラメータは 0 または次の値を指定できる。
dwDesiredAccess : [int] デスクトップへのアクセス。値の一覧については Desktop Security and Access Rights を参照。CreateDesktop は内部でハンドルを使ってウィンドウを作成するため、このパラメータには DESKTOP_CREATEWINDOW アクセス権を含める必要がある。
lpsa : [var] 返されるハンドルが子プロセスに継承可能かどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインタ。lpsa が NULL の場合、ハンドルは継承されない。構造体の lpSecurityDescriptor メンバは、新しいデスクトップのセキュリティ記述子を指定する。NULL の場合、デスクトップは親ウィンドウステーションからセキュリティ記述子を継承する。

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

解説

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

[戻り値]

関数が成功した場合、戻り値は新しく作成されたデスクトップへのハンドル。指定されたデスクトップが既に存在する場合、関数は成功し、既存のデスクトップへのハンドルを返す。ハンドルの使用が終わったら
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" サブ文字列の値は次のとおり:
（以下省略）

情報