HrGetAutoDiscoverXML

Hace referencia a: Outlook 2013 | Outlook 2016

Devuelve un flujo de lenguaje de marcado extensible (XML) que representa la información recuperada del servicio de detección automática de un servidor de Microsoft Exchange 2007.

Información rápida

HRESULT HrGetAutoDiscoverXML( 
    __in_z const WCHAR *pwzAddress, 
    __in_opt_z const WCHAR *pwzPassword, 
    __in_opt HANDLE hCancelEvent, 
    __in_opt ULONG ulFlags, 
    __out IStream** ppXmlStream); 

Parameters

pwzAddress

[in] Dirección de correo electrónico smtp (Simple Mail Transfer Protocol) terminada en null de la cuenta para la que desea recuperar la información de detección automática.

pwzPassword

[in] Una contraseña opcional para la cuenta especificada por pwzAddress. Tenga en cuenta que pasar cualquier contraseña no tiene ningún efecto si la cuenta especificada por pwzAddress no requiere una contraseña.

hCancelEvent

[in] Un identificador de eventos win32 no establecido que es opcional y se puede usar para cancelar la operación. Para cancelar la operación, establezca el evento y pase el identificador de evento como hCancelEvent; pase null si no desea cancelar la operación. Tenga en cuenta que pasar un valor que no representa un identificador de evento no tiene ningún efecto y la función lo omite.

ulFlags

[in] No se usa este parámetro. Debe ser 0.

ppXmlStream

[out] Puntero a un objeto IStream que contiene el XML de detección automática. Devuelve null si se produce un error en la operación de detección automática. Debe liberar el objeto IStream cuando haya terminado con él.

Valores devueltos

S_OK

• La llamada a la función se realiza correctamente.

E_INVALIDARG

• pwzAddress es null o no es una dirección SMTP válida, o ppXmlStream es un puntero nulo a un objeto IStream .

MAPI_E_NOT_FOUND

• El equipo cliente no está conectado a la red, el equipo cliente no está conectado a un servidor de Microsoft Exchange 2007, pwzAddress no es una cuenta en un servidor de Exchange 2007 o pwzAddress es una cuenta que no admite el servicio de detección automática de Exchange.

MAPI_E_USER_CANCEL

• Se ha pasado un identificador de evento a hCancelEvent para cancelar la operación.

STRSAFE_E_INSUFFICIENT_BUFFER

• El valor pasado a pwzAddress o pwzPassword es demasiado largo, de modo que desborda el búfer interno de 256 bytes.