IFunctionDiscoveryProviderFactory::CreateInstance-Methode (functiondiscoveryprovider.h)

[Die Funktionsermittlung ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Erstellt eine Funktion instance. Alle Funktionsinstanzen sollten mit dieser Methode erstellt werden. Andere Implementierungen, die IFunctionInstance unterstützen, sollten nicht verwendet werden.

Syntax

HRESULT CreateInstance(
  [in]  const WCHAR                *pszSubCategory,
  [in]  const WCHAR                *pszProviderInstanceIdentity,
  [in]  INT_PTR                    iProviderInstanceContext,
  [in]  IPropertyStore             *pIPropertyStore,
  [in]  IFunctionDiscoveryProvider *pIFunctionDiscoveryProvider,
  [out] IFunctionInstance          **ppIFunctionInstance
);

Parameter

[in] pszSubCategory

Die Unterkategoriezeichenfolge für die Funktion instance. Weitere Informationen finden Sie unter Unterkategoriedefinitionen.

[in] pszProviderInstanceIdentity

Der Anbieter instance Bezeichner.

Die Funktionsermittlung verwendet diesen Bezeichner, um sicherzustellen, dass die von IFunctionInstance::GetID zurückgegebenen Bezeichner instance eindeutig sind. Zu diesem Zweck fügt die Funktionsermittlung ein Präfix an den an pszProviderInstanceIdentity übergebenen Bezeichner an, um sicherzustellen, dass eine bestimmte Funktion instance Bezeichner für alle Anbieter eindeutig ist. Implementierer müssen nur sicherstellen, dass pszProviderInstanceIdentity das Gerät, die Ressource oder die instance innerhalb des Bereichs des Anbieters eindeutig identifiziert.

Diese Zeichenfolge wird an Clientanwendungen zurückgegeben, die IFunctionInstance::GetProviderInstanceID aufrufen.

Es gibt keine Obergrenze für die Größe dieser Zeichenfolge.

[in] iProviderInstanceContext

Der der spezifischen Funktion zugeordnete Kontext instance.

[in] pIPropertyStore

Ein Zeiger auf eine IPropertyStore-Schnittstelle .

[in] pIFunctionDiscoveryProvider

Ein Zeiger auf den IFunctionDiscoveryProvider-Anbieter instance Erstellen dieser Funktion instance.

[out] ppIFunctionInstance

Ein Zeiger auf eine IFunctionInstance-Schnittstelle .

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Anbieter sollte die Unterkategorie (kann NULL sein), den instance Bezeichner, einen vom Anbieter zugewiesenen Kontext (falls erforderlich) und einen optionalen Eigenschaftenspeicher angeben.

CreateInstance gibt eine entsprechend initialisierte Funktion instance an den Anbieter zurück.

Der vom Anbieter angegebene Kontext wird für alle nachfolgenden Funktionen instance verwandten Methoden wie InstanceReleased, InstancePropertyStoreOpen, InstancePropertyStoreFlush und InstanceQueryService an den Anbieter zurückgegeben.

Der Anbieter muss sicherstellen, dass die Anzahl der Anbieterverweis nicht auf Null geht, möglicherweise in einem anderen Thread, während CreateInstance aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	functiondiscoveryprovider.h

Weitere Informationen

IFunctionDiscoveryProviderFactory