IXPLogon::Poll
The IXPLogon::Poll
method checks whether a transport provider has one or more incoming messages
available.
Quick Info
See IXPLogon
: IUnknown.
HRESULT Poll(
|
ULONG FAR * lpulIncoming |
|
|
) |
|
Parameters
lpulIncoming
[out] Value
indicating the existence of incoming messages. A nonzero value indicates that
there are incoming messages.
Returned Values
S_OK
The call
succeeded and has returned the expected value or values.
Remarks
The MAPI
spooler periodically calls the IXPLogon::Poll method if the transport
provider indicates it must be polled for new messages; it does so by passing
the LOGON_SP_POLL flag to the call to the IXPProvider::TransportLogon method at the beginning of
a session. If the transport provider indicates in response to the Poll call
that there are one or more inbound messages available for it to process, the
MAPI spooler calls the IXPLogon::StartMessageM3JVGL method to allow the provider to process
the first incoming message. The transport provider indicates incoming messages
by setting the value in the Poll lpulIncoming parameter to
nonzero.
See Also