IMAPISupport::OpenProfileSection

适用于:Outlook 2013 | Outlook 2016

打开当前配置文件的一部分,并返回 IProfSect 指针以供进一步访问。

HRESULT OpenProfileSection(
LPMAPIUID lpUid,
ULONG ulFlags,
LPPROFSECT FAR * lppProfileObj
);

参数

lpUid

[in]指向 MAPIUID 结构的指针,该结构标识要打开的配置文件部分。 为 lpUid 参数传递 NULL 会打开调用方配置文件部分。

ulFlags

[in]控制配置文件部分的打开方式的标志的位掩码。 可以设置以下标志:

MAPI_DEFERRED_ERRORS

允许 OpenProfileSection 成功返回,可能是在调用方完全可访问配置文件部分之前。 如果无法访问配置文件部分,则进行后续对象调用可能会导致错误。

MAPI_MODIFY

请求读/写权限。 默认情况下,对象以只读方式打开,调用方不应假定已授予读/写权限。

lppProfileObj

[out]指向打开的配置文件部分的指针的指针。

返回值

S_OK

配置文件部分已成功打开。

MAPI_E_NO_ACCESS

尝试修改只读配置文件部分或访问调用方权限不足的对象。

MAPI_E_NOT_FOUND

没有与 在 lpEntryID 中传递的条目标识符关联的配置文件部分。

MAPI_E_UNKNOWN_FLAGS

使用了保留标志或不受支持的标志,因此操作未完成。

备注

为所有支持对象实现 IMAPISupport::OpenProfileSection 方法。 服务提供商和消息服务调用 OpenProfileSection 以打开配置文件部分并检索指向其 IProfSect 接口实现的指针。

给调用方的说明

OpenProfileSection 将配置文件部分打开为只读,除非你在 ulFlags 参数中设置了 MAPI_MODIFY 标志并且你的权限已足够。 设置此标志不保证读/写权限;授予的权限取决于访问级别和 对象。

如果 OpenProfileSection 尝试以只读的形式打开不存在的配置文件部分,则返回MAPI_E_NOT_FOUND。 如果 OpenProfileSection 尝试以读/写的形式打开不存在的配置文件部分,它将创建配置文件部分并返回 IProfSect 指针。

另请参阅

IMAPIProp : IUnknown

IProfSect : IMAPIProp

MAPIUID

IMAPISupport : IUnknown