CoRegisterMessageFilter 함수(objbase.h)

현재 스레드에서 동시성 문제를 처리하는 데 사용되는 IMessageFilter 인터페이스의 instance OLE에 등록합니다. 각 스레드에 대해 하나의 메시지 필터만 등록할 수 있습니다. 다중 스레드 아파트의 스레드에는 메시지 필터가 있을 수 없습니다.

구문

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

매개 변수

[in, optional] lpMessageFilter

메시지 필터의 IMessageFilter 인터페이스에 대한 포인터입니다. 이 메시지 필터는 이전 메시지 필터(있는 경우)를 대체하여 현재 스레드에 등록해야 합니다. 이 매개 변수는 현재 스레드에 메시지 필터를 등록해서는 안 됨을 나타내는 NULL일 수 있습니다.

이 함수는 메시지 필터에 대한 인터페이스 포인터에서 AddRef 를 호출합니다.

[out, optional] lplpMessageFilter

이전에 등록된 메시지 필터에 대한 인터페이스 포인터를 수신하는 IMessageFilter* 포인터 변수의 주소입니다. 현재 스레드에 대해 이전에 등록된 메시지 필터가 없는 경우 *lplpMessageFilter 값은 NULL입니다.

반환 값

instance 성공적으로 등록되었거나 해지된 경우 반환 값은 S_OK, 그렇지 않으면 S_FALSE.

설명

등록된 메시지 필터를 취소하려면 이전 메시지 필터( NULL일 수 있음)를 lpMessageFilter 매개 변수로 CoRegisterMessageFilter에 전달합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	objbase.h
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

IMessageFilter