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
已成功建立或删除默认配置文件。
E_FAIL
无法将指定的配置文件设置为默认配置文件。
MAPI_E_NOT_FOUND
指定的配置文件不存在。
备注
IProfAdmin::SetDefaultProfile 方法将特定配置文件建立为客户端的默认配置文件,或清除当前默认配置文件。 无法将“应用”配置文件设置为默认配置文件。 默认配置文件是客户端开始 MAPI 会话时自动使用的配置文件。 SetDefaultProfile 还会将新默认配置文件的 PR_DEFAULT_PROFILE (PidTagDefaultProfile) 属性设置为 TRUE。
给调用方的说明
若要使用默认配置文件启动会话,请将 MAPI_USE_DEFAULT 标志传递给 MAPILogonEx 函数。