IProfAdmin::DeleteProfile
适用于:Outlook 2013 | Outlook 2016
删除配置文件。
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
参数
lpszProfileName
[in]指向要删除的配置文件名称的指针。
ulFlags
[in]控制如何删除配置文件的标志的位掩码。 可以设置以下标志:
MAPI_APP_PROFILE
允许删除“应用”配置文件。 如果要删除的配置文件是“应用”配置文件,则必须设置此标志。
可能无法在所有 MAPI 实现中识别或支持此标志。
返回值
S_OK
已成功删除配置文件。
MAPI_E_NO_ACCESS
配置文件是“应用”配置文件,未设置MAPI_APP_PROFILE标志。
MAPI_E_NOT_FOUND
指定的配置文件不存在。
备注
IProfAdmin::D eleteProfile 方法删除配置文件。 如果在调用 DeleteProfile 时正在使用要删除的配置文件, 则 DeleteProfile 将返回S_OK但不立即删除配置文件。 相反, DeleteProfile 会标记要删除的配置文件,并在不再使用配置文件的所有活动会话结束后将其删除。
使用 ulContext 参数中设置的 MSG_SERVICE_DELETE 值调用配置文件中每个消息服务的入口点函数。 首先,函数删除服务,然后删除服务的配置文件部分。 删除服务后,不会再次调用消息服务入口点函数。
删除配置文件不需要密码。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MAPIProfileFunctions.cpp |
HrRemoveProfile |
MFCMAPI 使用 IProfAdmin::D eleteProfile 方法删除所选配置文件。 |