Compartir a través de


IProfAdmin::SetDefaultProfile

Hace referencia a: Outlook 2013 | Outlook 2016

Establece o borra el perfil predeterminado de un cliente.

HRESULT SetDefaultProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);

Parameters

lpszProfileName

[in] Puntero al nombre del perfil que se convertirá en el valor predeterminado o NULL. Establecer lpszProfileName en NULL indica que SetDefaultProfile debe quitar el perfil predeterminado existente, dejando el cliente sin un valor predeterminado.

ulFlags

[in] Máscara de bits de marcas que controla el tipo de cadena a la que apunta lpszProfileName. Se puede establecer la marca siguiente:

MAPI_UNICODE

El nombre del perfil está en formato Unicode. Si no se establece la marca de MAPI_UNICODE, el nombre del perfil está en formato ANSI.

Valor devuelto

S_OK

Se estableció o quitó correctamente un perfil predeterminado.

E_FAIL

El perfil especificado no se puede establecer como perfil predeterminado.

MAPI_E_NOT_FOUND

El perfil especificado no existe.

Comentarios

El método IProfAdmin::SetDefaultProfile establece un perfil determinado como perfil predeterminado del cliente o borra el perfil predeterminado actual. No se puede establecer un perfil de "aplicación" como perfil predeterminado. El perfil predeterminado es el perfil que se usa automáticamente cada vez que el cliente inicia una sesión MAPI. SetDefaultProfile también establece la propiedad PR_DEFAULT_PROFILE (PidTagDefaultProfile) del nuevo perfil predeterminado en TRUE.

Notas para los llamadores

Para iniciar una sesión con el perfil predeterminado, pase la marca de MAPI_USE_DEFAULT a la función MAPILogonEx .

Recursos adicionales

IProfAdmin::GetProfileTable

MAPILogonEx

Propiedad canónica PidTagDefaultProfile

IProfAdmin : IUnknown