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