Partager via

HrGetAutoDiscoverXML

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Renvoie un flux XML (Extensible Markup Language) qui représente les informations récupérées à partir du service de découverte automatique d’un serveur Microsoft Exchange 2007.

Informations rapides

Propriété Valeur
Exporté par :
 olmapi32.dll
Appelé par :
 Client
Implémenté par :
 Outlook
 
HRESULT HrGetAutoDiscoverXML( 
    __in_z const WCHAR *pwzAddress, 
    __in_opt_z const WCHAR *pwzPassword, 
    __in_opt HANDLE hCancelEvent, 
    __in_opt ULONG ulFlags, 
    __out IStream** ppXmlStream);

Paramètres

pwzAddress

[in] Adresse e-mail SMTP (Simple Mail Transfer Protocol) terminée par null du compte pour lequel vous souhaitez récupérer les informations de découverte automatique.

pwzPassword

[in] Mot de passe facultatif pour le compte spécifié par pwzAddress. Notez que le passage d’un mot de passe n’a aucun effet si le compte spécifié par pwzAddress ne nécessite pas de mot de passe.

hCancelEvent

[in] Un handle d’événement Win32 non défini qui est facultatif et peut être utilisé pour annuler l’opération. Pour annuler l’opération, définissez l’événement et transmettez le handle d’événement comme hCancelEvent ; passez null si vous ne souhaitez pas annuler l’opération. Notez que le passage d’une valeur qui ne représente pas de handle d’événement n’a aucun effet et est ignoré par la fonction .

ulFlags

[in] Ce paramètre n’est pas utilisé. Il doit être 0.

ppXmlStream

[out] Pointeur vers un objet IStream qui contient le code XML de découverte automatique. Retourne null si l’opération de découverte automatique échoue. Vous devez libérer l’objet IStream lorsque vous en avez terminé.

Valeurs de retour

S_OK

  • L’appel de fonction a réussi.

E_INVALIDARG

  • pwzAddress a la valeur null ou n’est pas une adresse SMTP valide, ou ppXmlStream est un pointeur Null vers un objet IStream .

MAPI_E_NOT_FOUND

  • L’ordinateur client n’est pas connecté au réseau, l’ordinateur client n’est pas connecté à un serveur Microsoft Exchange 2007, pwzAddress n’est pas un compte sur un serveur Exchange 2007 ou pwzAddress est un compte qui ne prend pas en charge le service de découverte automatique Exchange.

MAPI_E_USER_CANCEL

  • Un handle d’événement a été passé à hCancelEvent pour annuler l’opération.

STRSAFE_E_INSUFFICIENT_BUFFER

  • La valeur passée à pwzAddress ou pwzPassword est trop longue, de sorte qu’elle dépasse la mémoire tampon interne de taille 256 octets.