Freigeben über

IProviderAdmin::CreateProvider

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Fügt dem Nachrichtendienst einen Dienstanbieter hinzu.

HRESULT CreateProvider(
  LPSTR lpszProvider,
  ULONG cValues,
  LPSPropValue lpProps,
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  MAPIUID FAR * lpUID
);

Parameter

lpszProvider

[in] Ein Zeiger auf den Namen des hinzuzufügenden Anbieters.

cValues

[in] Die Anzahl der Eigenschaftswerte, auf die der lpProps-Parameter verweist.

lpProps

[in] Ein Zeiger auf ein Eigenschaftswertarray, das die Eigenschaften des hinzuzufügenden Anbieters beschreibt.

ulUIParam

[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden. Der ulUIParam-Parameter wird verwendet, wenn das flag MAPI_DIALOG im ulFlags-Parameter festgelegt ist.

ulFlags

[in] Eine Bitmaske von Flags, die die Anbieterzugabe steuert. Die folgenden Flags können festgelegt werden:

  • MAPI_DIALOG: Zeigt ein Dialogfeld zur Eingabe von Konfigurationsinformationen an.

  • MAPI_UNICODE: Der Anbietername und die Zeichenfolgeneigenschaften liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen diese Zeichenfolgen im ANSI-Format vor.

lpUID

[out] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner enthält, der den hinzuzufügenden Anbieter darstellt.

Rückgabewert

S_OK

Der Anbieter wurde dem Nachrichtendienst erfolgreich hinzugefügt.

MAPI_E_USER_CANCEL

Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.

Hinweise

Die IProviderAdmin::CreateProvider-Methode fügt dem Nachrichtendienst einen Dienstanbieter hinzu. Der lpszProvider-Parameter muss auf den Namen eines Anbieters verweisen, der zum Nachrichtendienst gehört. CreateProvider überprüft nicht, ob der Name mit dem Namen eines Anbieters im Dienst übereinstimmt. Wenn der übergebene Name nicht mit einem Dienstnamen übereinstimmt, ist der Aufruf erfolgreich, aber die Ergebnisse sind unvorhersehbar. Die meisten Nachrichtendienste lassen nicht zu, dass Anbieter hinzugefügt oder gelöscht werden, während das Profil verwendet wird.

Nachdem alle verfügbaren Informationen über den Dienstanbieter dem Profil aus der Datei Mapisvc.inf hinzugefügt wurden, ruft CreateProvider die Einstiegspunktfunktion des Nachrichtendiensts auf, wobei der ulContext-Parameter auf MSG_SERVICE_PROVIDER_CREATE festgelegt ist. Wenn MAPI_DIALOG im ulFlags-Parameter der CreateProvider-Methode festgelegt ist, werden die Werte in den Parametern ulUIParam und ulFlags ebenfalls an die Einstiegspunktfunktion übergeben. Diese zusätzlichen Parameter ermöglichen es dem Dienstanbieter, sein Eigenschaftenblatt anzuzeigen, damit der Benutzer Konfigurationseinstellungen eingeben kann.

Siehe auch