.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH CoRegisterMessageFilter 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBCoRegisterMessageFilter\fR (OLE32.@)
.SH SYNOPSIS
HRESULT CoRegisterMessageFilter
 (
  LPMESSAGEFILTER  \fIlpMessageFilter\fR,
  LPMESSAGEFILTER* \fIlplpMessageFilter\fR
 )

.SH DESCRIPTION
.PP
Registers a message filter. 

.SH PARAMS
\fIlpMessageFilter\fR \fB[In]\fR  Pointer to interface.
.PP
\fIlplpMessageFilter\fR \fB[Out]\fR  Indirect pointer to prior instance if non-NULL.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. 
.PP
\fBFailure:\fR \fBHRESULT\fR code. 

.SH NOTES
.PP
Both \fIlpMessageFilter\fR and \fIlplpMessageFilter\fR are optional. Passing in a \fBNULL\fR \fIlpMessageFilter\fR removes the message filter. 
.PP
If \fIlplpMessageFilter\fR is not \fBNULL\fR the previous message filter will be returned in the memory pointer to this parameter and the caller is responsible for releasing the object. 
.PP
The current thread be in an apartment otherwise the function will crash. 

.SH IMPLEMENTATION
.PP
Declared in \fB"objbase.h"\fR. 
.PP
Implemented in \fB"dlls/ole32/compobj.c"\fR. 
.PP
Debug channel \fB"ole"\fR.