RmRegisterResources 関数 (restartmanager.h)

  • [アーティクル]

リソースを再起動マネージャー セッションに登録します。 再起動マネージャーは、セッションに登録されているリソースの一覧を使用して、シャットダウンして再起動する必要があるアプリケーションとサービスを決定します。 リソースは、ファイル名、サービス短縮名、または実行中のアプリケーション を記述するRM_UNIQUE_PROCESS 構造で識別できます。 RmRegisterResources 関数は、プライマリ インストーラーまたはセカンダリ インストーラーで使用できます。

構文

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

パラメーター

[in] dwSessionHandle

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

[in] nFiles

登録されているファイルの数。

[in, optional] rgsFileNames

完全なファイル名パスの null で終わる文字列の配列。 nFiles が 0 の場合、このパラメーターは NULL にすることができます。

[in] nApplications

登録されているプロセスの数。

[in, optional] rgApplications

RM_UNIQUE_PROCESS構造体の配列。 nApplications が 0 の場合、このパラメーターは NULL にすることができます。

[in] nServices

登録するサービスの数。

[in, optional] rgsServiceNames

サービスの短い名前の null で終わる文字列の配列。 nServices が 0 の場合、このパラメーターは NULL にすることができます。

戻り値

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

値 意味
ERROR_SUCCESS
0
 指定されたリソースが登録されています。
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
 指定されたハンドルに対して再起動マネージャー セッションが存在しません。

注釈

RmRegisterResources 関数を呼び出すたびに、比較的負荷の高い書き込み操作が実行されます。 ファイルごとに 1 回この関数を呼び出さないでください。代わりに、関連ファイルをコンポーネントにグループ化して、これらを一緒に登録します。

要件

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