IMSLogon::OpenStatusEntry
The IMSLogon::OpenStatusEntry
method opens a status object.
Quick Info
See IMSLogon
: IUnknown.
HRESULT OpenStatusEntry(
|
LPCIID lpInterface, |
|
|
ULONG ulFlags,
|
|
|
ULONG FAR * lpulObjType, |
|
|
LPVOID FAR * lppEntry |
|
|
) |
|
Parameters
lpInterface
[in] Pointer
to the interface identifier (IID) for the
status object to open. Passing NULL indicates the standard interface for the
object is returned, in this case the IMAPIStatus interface. The lpInterface
parameter can also be set to an identifier for an appropriate interface for
the object.
ulFlags
[in] Bitmask
of flags that controls how the status object is opened. The following flag can
be set:
MAPI_MODIFY
Requests
read/write access. By default, objects are created with read-only access, and
client applications should not work on the assumption that read/write access
has been granted.
lpulObjType
[out] Pointer
to the type of the opened object.
lppEntry
[out] Pointer
to the pointer to the opened object.
Return Value
S_OK
The call
succeeded and has returned the expected value or values.
Remarks
Message store
providers implement the IMSLogon::OpenStatusEntry method to open a
status object. This status object is then used to enable clients to call IMAPIStatus
methods; for example, clients can use the IMAPIStatus::SettingsDialog
method to reconfigure the message store logon session or the IMAPIStatus::ValidateState
method to validate the state of the message store logon session.
See Also