coRegisterMessageFilter 函式 (objbase.h)

向 OLE 註冊 IMessageFilter 介面的實例，此介面用於處理目前線程上的並行問題。每個線程只能註冊一個訊息篩選。多線程 Apartment 中的線程不能有訊息篩選。

語法

HRESULT CoRegisterMessageFilter(
  [in, optional]  LPMESSAGEFILTER lpMessageFilter,
  [out, optional] LPMESSAGEFILTER *lplpMessageFilter
);

[in, optional] lpMessageFilter

訊息篩選上 IMessageFilter 介面的指標。如果有任何) ，則此訊息篩選應該在目前的線程上註冊，取代先前的訊息篩選 (。這個參數可以是 NULL，表示目前線程上不應該註冊任何訊息篩選。

請注意，此函式會在訊息篩選的介面指標上呼叫 AddRef 。

[out, optional] lplpMessageFilter

接收先前已註冊訊息篩選之介面指標的 IMessageFilter* 指標變數位址。如果目前線程沒有先前註冊的訊息篩選，則 *lplpMessageFilter 的值是 NULL。

如果已成功註冊或撤銷實例，則傳回值會S_OK;否則，它會S_FALSE。

若要撤銷已註冊的訊息篩選，請將先前的訊息篩選 (可能 為 NULL) 當做 lpMessageFilter 參數傳遞至 CoRegisterMessageFilter。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	objbase.h
程式庫	Ole32.lib
Dll	Ole32.dll