IABLogon::OpenStatusEntry
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Opens the provider's status object.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPMAPISTATUS FAR * lppEntry
);
Parameters
lpInterface
[in] A pointer to the interface identifier (IID) that represents the interface that must be used to access the status object. Passing NULL returns the object's standard interface, IMAPIStatus : IMAPIProp.ulFlags
[in] A bitmask of flags that controls how the status object is opened. The following flag can be set:- MAPI_MODIFY
Requests read/write permission. By default, objects are opened with read-only access, and callers should not assume that read/write permission has been granted.
- MAPI_MODIFY
lpulObjType
[out] A pointer to the type of the opened object.lppEntry
[out] A pointer to a pointer to the opened object.
Return Value
- S_OK
The call succeeded and the status object has been opened.
Remarks
Address book providers implement the OpenStatusEntry method to grant access to their status object. All address book providers are required to implement a status object that supports, at a minimum, the IMAPIStatus::ValidateState method. For more information, see Status Object Implementation.