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 还会将新默认配置文件的 PR_DEFAULT_PROFILE (PidTagDefaultProfile) 属性设置为 TRUE。

给调用方的说明

若要使用默认配置文件启动会话,请将 MAPI_USE_DEFAULT 标志传递给 MAPILogonEx 函数。

另请参阅

IProfAdmin::GetProfileTable

MAPILogonEx

PidTagDefaultProfile 规范属性

IProfAdmin : IUnknown