次の方法で共有

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
 指定されたハンドルに対して再起動マネージャー セッションが存在しません。
ERROR_ACCESS_DENIED
5
 再起動マネージャー セッションに登録されているパスはディレクトリです。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー restartmanager.h
ライブラリ Rstrtmgr.lib
DLL Rstrtmgr.dll

関連項目

RmCancelCurrentTask