RmRemoveFilter 関数 (restartmanager.h)

  • [アーティクル]

RmAddFilter 関数を使用して適用されたシャットダウンまたは再起動アクションに対する変更を削除します。 プライマリ インストーラーは、 RmRemoveFilter 関数を複数回呼び出すことができます。

構文

DWORD RmRemoveFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName
);

パラメーター

[in] dwSessionHandle

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

[in, optional] strModuleName

アプリケーションの実行可能ファイルの完全なパスを含む null で終わる文字列値へのポインター。 RmRemoveFilter 関数は、以前に RmAddFilter 関数によって適用された、参照されているアプリケーションのシャットダウンまたは再起動アクションに対する変更を削除します。 Application または strServiceShortName パラメーターが NULL 以外の場合、このパラメーターは NULL である必要があります。

[in, optional] pProcess

アプリケーションの RM_UNIQUE_PROCESS 構造。 RmRemoveFilter 関数は、以前に RmAddFilter 関数によって適用された、参照されているアプリケーションのシャットダウンまたは再起動アクションに対する変更を削除します。 strFilename パラメーターまたは strShortServiceName パラメーターが NULL 以外の場合、このパラメーターは NULL である必要があります。

[in, optional] strServiceShortName

短いサービス名を含む null で終わる文字列値へのポインター。 RmRemoveFilter 関数は、以前に RmAddFilter 関数によって適用された、参照されているサービスのシャットダウンまたは再起動アクションに対する変更を削除します。 strFilename パラメーターまたは Application パラメーターが NULL 以外の場合、このパラメーターは NULL である必要があります。

戻り値

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

値 意味
ERROR_SUCCESS
0
 関数は正常に終了しました。
ERROR_FILE_NOT_FOUND
1
 指定したフィルターが見つかりませんでした。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 このエラーは、セカンダリ インストーラーがこの関数を呼び出すと返されます。 この関数は、プライマリ インストーラーでのみ使用できます。

要件

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