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 指针。