RmGetFilterList 関数 (restartmanager.h)

  • [アーティクル]

RmAddFilter 関数によって既に適用されているシャットダウンおよび再起動アクションの変更をListsします。 関数は、適用された変更に関する情報を含むバッファーへのポインターを返します。

構文

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

パラメーター

[in] dwSessionHandle

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

[out, optional] pbFilterBuf

変更情報を含むバッファーへのポインター。

[in] cbFilterBuf

変更情報を含むバッファーのサイズ (バイト単位)。

[out] cbFilterBufNeeded

バッファーに必要なバイト数。

戻り値

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

値 意味
ERROR_SUCCESS
0
 関数は正常に終了しました。
ERROR_BAD_ARGUMENTS
160
 1 つ以上の引数が正しくありません。 NULL ポインターまたは 0 が null 以外の値と 0 以外の値を必要とするパラメーターとして渡された場合、このエラー値は Restart Manager 関数によって返されます。
ERROR_MORE_DATA
234
 このエラー値は、pbFilterBuf バッファーが小さすぎてリスト内のすべてのアプリケーション情報を保持できない場合、または cbFilterBufNeeded が指定されていない場合に、RmGetFilterList 関数によって返されます。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 このエラーは、セカンダリ インストーラーがこの関数を呼び出すと返されます。 この関数は、プライマリ インストーラーでのみ使用できます。

注釈

返された pbFilterBuf バッファーは、フィルター リストにアクセスするために RM_FILTER_INFO に型キャストする必要があります。

要件

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

こちらもご覧ください

RmAddFilter