MI_Application_NewHostedProvider-Funktion (mi.h)

  • Artikel

Registriert einen gehosteten Anbieter bei der WMI-Engine auf dem lokalen Computer.

Syntax

MI_INLINE MI_Result MI_Application_NewHostedProvider(
  [in]            MI_Application    *application,
  [in]            const MI_Char     *namespaceName,
  [in]            const MI_Char     *providerName,
  [in]            MI_MainFunction   mi_Main,
  [out, optional] MI_Instance       **extendedError,
  [out]           MI_HostedProvider *hostedProvider
);

Parameter

[in] application

Ein Zeiger auf den Handle, der von der funktion MI_Application_Initialize zurückgegeben wird.

[in] namespaceName

Ein Zeiger auf den Namespace, in dem der Anbieter registriert ist. Beispiel: L"root/cimv2".

[in] providerName

Ein Zeiger auf den Anbieternamen, der bei der WMI-Engine für diesen gehosteten Anbieter registriert ist.

[in] mi_Main

Haupteinstiegspunkt zu einem MI-Anbieter.

[out, optional] extendedError

Ein Zeiger auf einen Zeiger auf einen optionalen Parameter, um erweiterte Fehlerinformationen zu empfangen, falls die API ausfällt. Wenn ein Zeiger übergeben wird, wird möglicherweise ein Fehler instance zurückgegeben. Wenn ein Fehler instance zurückgegeben wird, löschen Sie ihn nach Abschluss der Verwendung mithilfe der MI_Instance_Delete-Funktion.

[out] hostedProvider

Ein Zeiger auf ein zurückgegebenes gehostetes Anbieterhandle. Wenn Sie die Verwendung des Handles abgeschlossen haben, schließen Sie es, indem Sie die MI_HostedProvider_Close-Funktion während des Herunterfahrens aufrufen oder wenn der Anbieter keine Vorgangsanforderungen mehr empfangen muss.

Rückgabewert

Diese Funktion gibt MI_INLINE MI_Result zurück.

Hinweise

Ein gehosteter Anbieter ist ein Anbieter, der sich in einer Clientanwendung und nicht im Hostprozess des WMI-Diensts befindet. Der Client steuert die Lebensdauer dieser Anbieter. Gehostete Anbieter werden anders registriert als reguläre Anbieter. Diese andere Registrierung gibt an, dass der WMI-Dienst vom Client gehostet wird. Wenn Sie den Anbieter verwendet haben, sollte er von der Anwendung heruntergefahren werden, indem sie die MI_HostedProvider_Close-Funktion aufruft.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile mi.h
Verteilbare Komponente Windows Management Framework 3.0 unter Windows Server 2008 R2 mit SP1, Windows 7 mit SP1 und Windows Server 2008 mit SP2