共用方式為

rmGetFilterList 函式 (restartmanager.h)

  • 發行項

清單 已由 RmAddFilter 函式套用的關機和重新啟動動作的修改。 函式會傳回緩衝區的指標，其中包含已套用之修改的相關信息。

語法

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
 一或多個自變數不正確。 如果 NULL 指標或 0 傳遞為需要非 Null 和非零值的參數，則重新啟動管理員函式會傳回這個錯誤值。
ERROR_MORE_DATA
234
 如果 pbFilterBuf 緩衝區太小而無法保存清單中的所有應用程式資訊，或未指定 cbFilterBufNeeded，RmGetFilterList 函式會傳回此錯誤值。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 當次要安裝程式呼叫此函式時，會傳回此錯誤。 此函式僅適用於主要安裝程式。

備註

傳回的 pbFilterBuf 緩衝區必須是 typecast， 才能RM_FILTER_INFO 存取篩選清單。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 restartmanager.h
程式庫 Rstrtmgr.lib
Dll Rstrtmgr.dll

另請參閱

RmAddFilter