IMSProvider::SpoolerLogon
Gilt für: Outlook 2013 | Outlook 2016
Protokolliert den MAPI-Spooler in einem Nachrichtenspeicher.
HRESULT SpoolerLogon(
LPMAPISUP lpMAPISup,
ULONG_PTR ulUIParam,
LPSTR lpszProfileName,
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
LPCIID lpInterface,
ULONG cbSpoolSecurity,
LPBYTE lpbSpoolSecurity,
LPMAPIERROR FAR * lppMAPIError,
LPMSLOGON FAR * lppMSLogon,
LPMDB FAR * lppMDB
);
Parameter
lpMAPISup
[in] Ein Zeiger auf das MAPI-Unterstützungsobjekt für den Nachrichtenspeicher.
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
lpszProfileName
[in] Ein Zeiger auf eine Zeichenfolge, die den Namen des Profils enthält, das für die MAPI-Spooleranmeldung verwendet wird. Diese Zeichenfolge kann in Dialogfeldern angezeigt, in eine Protokolldatei geschrieben oder einfach ignoriert werden. Es muss im Unicode-Format vorliegen, wenn das MAPI_UNICODE-Flag im ulFlags-Parameter festgelegt ist.
cbEntryID
[in] Die Größe des Eintragsbezeichners in Bytes, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf den Eintragsbezeichner für den Nachrichtenspeicher. Die Übergabe von NULL im lpEntryID-Parameter gibt an, dass noch kein Nachrichtenspeicher ausgewählt wurde und Dialogfelder angezeigt werden können, in denen der Benutzer einen Nachrichtenspeicher auswählen kann.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die Anmeldung ausgeführt wird. Die folgenden Flags können festgelegt werden:
MAPI_DEFERRED_ERRORS
Der Aufruf kann auch dann erfolgreich ausgeführt werden, wenn das zugrunde liegende Objekt für die aufrufende Implementierung nicht verfügbar ist. Wenn das Objekt nicht verfügbar ist, löst ein nachfolgendes Aufrufen des Objekts möglicherweise einen Fehler aus.
MAPI_UNICODE
Die übergebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn MAPI_UNICODE nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
MDB_NO_DIALOG
Verhindert die Anzeige von Anmeldedialogfeldern. Wenn dieses Flag festgelegt ist, wird der Fehlerwert MAPI_E_LOGON_FAILED zurückgegeben, wenn die Anmeldung nicht erfolgreich ist. Wenn dieses Flag nicht festgelegt ist, kann der Nachrichtenspeicheranbieter den Benutzer auffordern, einen Namen oder ein Kennwort zu korrigieren, einen Datenträger einzufügen oder andere Aktionen auszuführen, die zum Herstellen einer Verbindung mit dem Speicher erforderlich sind.
MDB_WRITE
Fordert Lese-/Schreibberechtigungen an.
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), bei dem sich der Nachrichtenspeicher anmeldet. Die Übergabe von NULL gibt an, dass die MAPI-Schnittstelle für den Nachrichtenspeicher (IMsgStore) zurückgegeben wird. Der lpInterface-Parameter kann auch auf einen Bezeichner für eine geeignete Schnittstelle für den Nachrichtenspeicher festgelegt werden (z. B. IID_IUnknown oder IID_IMAPIProp).
cbSpoolSecurity
[in] Ein Zeiger auf die Größe der Validierungsdaten im Parameter lppbSpoolSecurity in Bytes.
lpbSpoolSecurity
[in] Ein Zeiger auf einen Zeiger auf Validierungsdaten. Die SpoolerLogon-Methode verwendet diese Daten, um den MAPI-Spooler in demselben Speicher zu protokollieren, bei dem sich der Nachrichtenspeicheranbieter zuvor mit der IMSProvider::Logon-Methode angemeldet hat.
lppMAPIError
[out] Ein Zeiger auf einen Zeiger auf die zurückgegebene MAPIERROR-Struktur , falls vorhanden, die Versions-, Komponenten- und Kontextinformationen für einen Fehler enthält. Der Parameter lppMAPIError kann auf NULL festgelegt werden, wenn keine MAPIERROR-Struktur zurückgegeben werden soll.
lppMSLogon
[out] Ein Zeiger auf den Zeiger auf das Anmeldeobjekt des Nachrichtenspeichers, bei dem MAPI sich anmelden soll.
lppMDB
[out] Ein Zeiger auf den Zeiger auf das Nachrichtenspeicherobjekt für den MAPI-Spooler und die Clientanwendungen, bei der sich die Anmeldung erfolgt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_UNCONFIGURED
Das Profil enthält nicht genügend Informationen für die Anmeldung. Wenn dieser Wert zurückgegeben wird, ruft MAPI die Einstiegspunktfunktion des Nachrichtenspeicheranbieters auf.
MAPI_W_ERRORS_RETURNED
Der Aufruf war erfolgreich, aber der Nachrichtenspeicheranbieter verfügt über Fehlerinformationen. Wenn diese Warnung zurückgegeben wird, sollte der Aufruf als erfolgreich behandelt werden. Verwenden Sie zum Testen auf diese Warnung das Makro HR_FAILED . Weitere Informationen finden Sie unter Verwenden von Makros für die Fehlerbehandlung. Rufen Sie die IMAPISession::GetLastError-Methode auf, um die Fehlerinformationen vom Anbieter abzurufen.
Hinweise
Der MAPI-Spooler ruft die IMSProvider::SpoolerLogon-Methode auf, um sich bei einem Nachrichtenspeicher anzumelden. Der MAPI-Spooler sollte das Nachrichtenspeicherobjekt verwenden, das vom Nachrichtenspeicheranbieter im lppMDB-Parameter während und nach der Anmeldung zurückgegeben wird.
Aus Gründen der Konsistenz mit der IMSProvider::Logon-Methode gibt der Anbieter auch ein Meldungsspeicher-Anmeldeobjekt im lppMSLogon-Parameter zurück. Die Verwendung des Store-Objekts und des Anmeldeobjekts ist für die übliche Store-Anmeldung identisch. Es sollte eine 1:1-Entsprechung zwischen dem Anmeldeobjekt und dem Speicherobjekt bestehen, sodass die Objekte so agieren, als wären sie ein Objekt, das zwei Schnittstellen verfügbar macht. Die beiden Objekte werden zusammen erstellt und gemeinsam freigegeben.
Der Speicheranbieter sollte das zurückgegebene Nachrichtenspeicherobjekt intern markieren, um anzugeben, dass der Speicher vom MAPI-Spooler verwendet wird. Einige der Methoden für dieses Speicherobjekt verhalten sich anders als für das Nachrichtenspeicherobjekt, das Clientanwendungen bereitgestellt wird. Das Beibehalten dieser internen Markierung ist die häufigste Methode, um das für den MAPI-Spooler spezifische Verhalten auszulösen.