EnumDesktopsA 関数 (winuser.h)
呼び出し元プロセスの指定したウィンドウ ステーションに関連付けられているすべてのデスクトップを列挙します。 この関数は、各デスクトップの名前をアプリケーション定義のコールバック関数に渡します。
構文
BOOL EnumDesktopsA(
[in, optional] HWINSTA hwinsta,
[in] DESKTOPENUMPROCA lpEnumFunc,
[in] LPARAM lParam
);
パラメーター
[in, optional] hwinsta
デスクトップを列挙するウィンドウ ステーションへのハンドル。 このハンドルは、
このパラメーターが NULL の場合は、現在のウィンドウ ステーションが使用されます。
[in] lpEnumFunc
アプリケーション定義の EnumDesktopProc コールバック関数へのポインター。
[in] lParam
コールバック関数に渡されるアプリケーション定義の値。
戻り値
関数が成功した場合は、lpEnumFuncによって指されたコールバック関数によって返される 0 以外の値
関数が列挙を実行できない場合、戻り値は 0 です。 GetLastError
コールバック関数が失敗した場合、戻り値は 0 です。 コールバック関数は、SetLastError
備考
EnumDesktops 関数は、呼び出し元プロセスがDESKTOP_ENUMERATEアクセス権を持つデスクトップのみを列挙します。 詳細については、「デスクトップ セキュリティとアクセス権の」を参照してください。
EnumDesktops 関数は、最後のデスクトップが列挙されるか、コールバック関数が FALSE を返すまで、lpEnumFunc コールバック関数を繰り返し呼び出します。
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EnumDesktops を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
関連項目
CreateWindowStation の
EnumDesktopProc の
GetProcessWindowStation の