IMsgServiceAdmin::ConfigureMsgService
Gilt für: Outlook 2013 | Outlook 2016
Konfiguriert einen Nachrichtendienst neu.
HRESULT ConfigureMsgService(
LPMAPIUID lpUID,
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG cValues,
LPSPropValue lpProps
);
Parameter
lpUID
[in] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner für den zu konfigurierenden Nachrichtendienst enthält.
ulUIParam
[in] Ein Handle für das übergeordnete Fenster des Konfigurationseigenschaftenblatts.
ulFlags
[in] Eine Bitmaske von Flags, die die Anzeige des Eigenschaftenblatts steuert. Die folgenden Flags können festgelegt werden:
MAPI_UNICODE
Die übergebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
MSG_SERVICE_UI_READ_ONLY
Der Nachrichtendienst sollte sein Konfigurationseigenschaftenblatt anzeigen, dem Benutzer jedoch nicht die Möglichkeit geben, es zu ändern. Die meisten Nachrichtendienste ignorieren dieses Flag.
SERVICE_UI_ALLOWED
Der Nachrichtendienst sollte sein Konfigurationseigenschaftenblatt nur anzeigen, wenn der Dienst nicht vollständig konfiguriert ist.
SERVICE_UI_ALWAYS
Der Nachrichtendienst muss immer sein Konfigurationseigenschaftenblatt anzeigen. Wenn SERVICE_UI_ALWAYS nicht festgelegt ist, kann weiterhin ein Konfigurationseigenschaftenblatt angezeigt werden, wenn SERVICE_UI_ALLOWED festgelegt ist und keine gültigen Konfigurationsinformationen aus dem Eigenschaftswertarray im lpProps-Parameter verfügbar sind. Es muss entweder SERVICE_UI_ALLOWED oder SERVICE_UI_ALWAYS festgelegt werden, damit ein Eigenschaftenblatt angezeigt wird.
cValues
[in] Die Anzahl der Eigenschaftswerte in der SPropValue-Struktur , auf die lpProps verweist.
lpProps
[in] Ein Zeiger auf ein Array von Eigenschaftswerten, die die eigenschaften beschreiben, die im Eigenschaftenblatt angezeigt werden sollen. Der lpProps-Parameter sollte nicht NULL sein, wenn der Nachrichtendienst ohne Benutzeroberfläche konfiguriert werden soll.
Rückgabewert
S_OK
Der Nachrichtendienst wurde erfolgreich konfiguriert.
MAPI_E_EXTENDED_ERROR
Ein für einen Nachrichtendienst spezifischer Fehler. Um die MAPIERROR-Struktur abzurufen, die den Fehler beschreibt, sollte die Clientanwendung die IMsgServiceAdmin::GetLastError-Methode aufrufen.
MAPI_E_NOT_FOUND
Die MAPIUID , auf die von lpUID verwiesen wird, stimmt nicht mit der eines vorhandenen Nachrichtendiensts überein.
MAPI_E_NOT_INITIALIZED
Der Nachrichtendienst verfügt nicht über eine Einstiegspunktfunktion.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang abgebrochen, in der Regel durch Klicken auf die Schaltfläche Abbrechen im Eigenschaftenblatt.
Hinweise
Die IMsgServiceAdmin::ConfigureMsgService-Methode ermöglicht die Konfiguration eines Nachrichtendiensts mit oder ohne Konfigurationseigenschaftenblatt.
Um die Konfiguration ohne Anzeige eines Eigenschaftenblatts zu ermöglichen, bereiten Nachrichtendienste in der Regel eine Headerdatei vor, die Konstanten für alle erforderlichen und optionalen Eigenschaften und deren Werte enthält.
Hinweise für Aufrufer
Um die MAPIUID-Struktur für den zu konfigurierenden Nachrichtendienst abzurufen, rufen Sie die spalte PR_SERVICE_UID (PidTagServiceUid) aus der Zeile des Nachrichtendiensts in der Nachrichtendiensttabelle ab. Weitere Informationen finden Sie in der in der IMsgServiceAdmin::CreateMsgService-Methode beschriebenen Prozedur.
Sie können einen Nachrichtendienst konfigurieren, ohne einem Benutzer ein Eigenschaftenblatt anzuzeigen, nur wenn Sie über Vorabinformationen zu den festzulegenden Eigenschaftswerten verfügen. Wenn Sie einen Nachrichtendienst konfigurieren, ohne ein Eigenschaftenblatt anzuzeigen, übergeben Sie gültige Eigenschaftswerte im lpProps-Parameter , und legen Sie die flags MSG_SERVICE_UI_READ_ONLY, SERVICE_UI_ALLOWED oder SERVICE_UI_ALWAYS nicht fest.
Wenn Sie alle oder einige Konfigurationsinformationen vom Benutzer über ein Eigenschaftenblatt erhalten, legen Sie SERVICE_UI_ALLOWED in ulFlags fest. Wenn Sie vorhandene Eigenschafteninformationen nur zum Einrichten von Standardeinstellungen verwenden und der Benutzer die Einstellungen ändern kann, legen Sie SERVICE_UI_ALWAYS in ulFlags fest.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI verwendet die IMsgServiceAdmin::ConfigureMsgService-Methode , um einen Dienst zu konfigurieren, der einem Profil hinzugefügt wurde. |