HrGetAutoDiscoverXML

Gilt für: Outlook 2013 | Outlook 2016

Gibt einen XML-Stream (Extensible Markup Language) zurück, der Informationen darstellt, die vom Dienst für die automatische Ermittlung eines Microsoft Exchange 2007-Servers abgerufen wurden.

QuickInfo

Eigenschaft	Wert
Exportiert von:	olmapi32.dll
Aufgerufen von:	Client
Implementiert von:	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); 

Parameter

pwzAddress

[in] Eine MIT NULL endende SMTP-E-Mail-Adresse (Simple Mail Transfer Protocol) des Kontos, für das Sie die Informationen zur automatischen Ermittlung abrufen möchten.

pwzPassword

[in] Ein optionales Kennwort für das von pwzAddress angegebene Konto. Beachten Sie, dass das Übergeben eines Kennworts keine Auswirkung hat, wenn für das von pwzAddress angegebene Konto kein Kennwort erforderlich ist.

hCancelEvent

[in] Ein nicht festgelegtes Win32-Ereignishandle, das optional ist und zum Abbrechen des Vorgangs verwendet werden kann. Um den Vorgang abzubrechen, legen Sie das Ereignis fest, und übergeben Sie das Ereignishandle als hCancelEvent; übergeben Sie NULL , wenn Sie den Vorgang nicht abbrechen möchten. Beachten Sie, dass das Übergeben eines Werts, der kein Ereignishandle darstellt, keine Auswirkung hat und von der Funktion ignoriert wird.

ulFlags

[in] Dieser Parameter wird nicht verwendet. Sie muss 0 sein.

ppXmlStream

[out] Ein Zeiger auf ein IStream-Objekt , das die AutoErmittlungs-XML enthält. Gibt NULL zurück, wenn der AutoErmittlungsvorgang fehlschlägt. Sie müssen das IStream-Objekt freigeben, wenn Sie damit fertig sind.

Rückgabewerte

S_OK

• Der Funktionsaufruf ist erfolgreich.

E_INVALIDARG

• pwzAddress ist NULL oder keine gültige SMTP-Adresse, oder ppXmlStream ist ein NULL-Zeiger auf ein IStream-Objekt .

MAPI_E_NOT_FOUND

• Der Clientcomputer ist nicht mit dem Netzwerk verbunden, der Clientcomputer ist nicht mit einem Microsoft Exchange 2007-Server verbunden, pwzAddress ist kein Konto auf einem Exchange 2007-Server, oder pwzAddress ist ein Konto, das den Exchange-Dienst für die automatische Ermittlung nicht unterstützt.

MAPI_E_USER_CANCEL

• Ein Ereignishandle wurde an hCancelEvent übergeben, um den Vorgang abzubrechen.

STRSAFE_E_INSUFFICIENT_BUFFER

• Der an pwzAddress oder pwzPassword übergebene Wert ist zu lang, sodass er den internen Puffer der Größe 256 Byte überläuft.