RmGetList 関数 (restartmanager.h)

  • [アーティクル]

Restart Manager セッションに登録されているリソースを現在使用しているすべてのアプリケーションとサービスの一覧を取得します。

構文

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

パラメーター

[in] dwSessionHandle

既存の再起動マネージャー セッションへのハンドル。

[out] pnProcInfoNeeded

影響を受けるすべてのアプリケーションとサービスの情報を返すために必要な RM_PROCESS_INFO 構造体を受け取るために必要な配列サイズへのポインター。

[in, out] pnProcInfo

配列内の RM_PROCESS_INFO 構造体の合計数と、塗りつぶされた構造体の数へのポインター。

[in, out, optional] rgAffectedApps

セッション に 登録されているリソースを使用してアプリケーションとサービスを一覧表示するRM_PROCESS_INFO構造体の配列。

[out] lpdwRebootReasons

システムの再起動が必要な理由を説明する RM_REBOOT_REASON 列挙の値を受け取る場所へのポインター。

戻り値

これは、受信した最新のエラーです。 この関数は、Winerror.h で定義されている システム エラー コード のいずれかを返すことができます。

値 説明
ERROR_SUCCESS
0
 関数は正常に終了しました。
ERROR_MORE_DATA
234
 rgAffectedApps バッファーが小さすぎて、リスト内のすべてのアプリケーション情報を保持しない場合、このエラー値は RmGetList 関数によって返されます。
ERROR_CANCELLED
1223
 現在の操作はユーザーによって取り消されます。
ERROR_SEM_TIMEOUT
121
 再起動マネージャー関数は、割り当てられた時間内にレジストリ書き込みミューテックスを取得できませんでした。 再起動マネージャーをさらに使用すると失敗する可能性があるため、システムの再起動をお勧めします。
ERROR_BAD_ARGUMENTS
160
 1 つ以上の引数が正しくありません。 Null 以外の値と 0 以外の値を必要とするパラメーターに NULL ポインターまたは 0 が渡された場合、このエラー値は Restart Manager 関数によって返されます。
ERROR_WRITE_FAULT
29
 操作でレジストリの読み取りまたは書き込みができませんでした。
ERROR_OUTOFMEMORY
14
 十分なメモリが使用できなかったため、再起動マネージャー操作を完了できませんでした。
ERROR_INVALID_HANDLE
6
 指定されたハンドルに対して再起動マネージャー セッションが存在しません。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー restartmanager.h
Library Rstrtmgr.lib
[DLL] Rstrtmgr.dll

関連項目

RmCancelCurrentTask