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 方法删除所选配置文件。

另请参阅

IMsgServiceAdmin::DeleteMsgService

MSGSERVICEENTRY

IProfAdmin : IUnknown

MFCMAPI 代码示例