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 で定義されている システム エラー コード のいずれかを返すことができます。

注釈

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

要件