IProfAdmin::SetDefaultProfile

适用于:Outlook 2013 | Outlook 2016

设置或清除客户端的默认配置文件。

HRESULT SetDefaultProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);

参数

lpszProfileName

[in]指向将成为默认配置文件的配置文件名称的指针,或 NULL。 将 lpszProfileName 设置为 NULL 指示 SetDefaultProfile 应删除现有的默认配置文件,使客户端没有默认配置文件。

ulFlags

[in]控制 lpszProfileName 指向的字符串类型的标志位掩码。 可以设置以下标志:

MAPI_UNICODE

配置文件名称采用 Unicode 格式。 如果未MAPI_UNICODE,则配置文件名称采用 ANSI 格式。

返回值

S_OK

已成功建立或删除默认配置文件。

MAPI_E_NOT_FOUND

指定的配置文件不存在。

备注

IProfAdmin::SetDefaultProfile 方法将特定配置文件建立为客户端的默认配置文件,或清除当前的默认配置文件。 默认配置文件是在客户端开始 MAPI 会话时自动使用的配置文件。 SetDefaultProfile 还将 PidTagDefaultProfile PR_DEFAULT_PROFILE (的新默认配置文件) 设置为 TRUE。

给调用方的说明

若要使用默认配置文件启动会话,MAPI_USE_DEFAULT MAPILogonEx 函数传递该标记。

另请参阅

IProfAdmin::GetProfileTable

MAPILogonEx

PidTagDefaultProfile 规范属性

IProfAdmin : IUnknown