Provider::GetObject(CInstance*,long,CFrameworkQuery&)-Methode (provider.h)

[Die Provider-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die GetObject-Methode wird von WMI aufgerufen, um eine instance einer Klasse abzurufen.

Syntax

HRESULT GetObject(
        CInstance         *pInstance,
  [ref] long              lFlags,
        CFrameworkQuery & Query
);

Parameter

pInstance

TBD

[ref] lFlags

Abfrageobjekt, das den Satz von Eigenschaften angibt, die aufgefüllt werden sollen, wie durch einen Aufruf von Provider::GetObject angefordert.

Ein Anbieter kann einen erheblichen Leistungsgewinn erzielen, indem er nur diese angeforderten Eigenschaftswerte eingibt. Der Anbieter bestimmt, welche Eigenschaften mithilfe von CFrameworkQuery::IsPropertyRequired angefordert werden. Andernfalls muss der Anbieter alle Eigenschaftswerte ausfüllen.

Query

TBD

Rückgabewert

Die Standardframeworkanbieterimplementierung dieser Methode gibt WBEM_E_PROVIDER_NOT_CAPABLE an die aufrufende Methode zurück. Die IWbemServices::GetObject-Methode listet die allgemeinen Rückgabewerte auf, obwohl Sie einen beliebigen COM-Rückgabewert implementieren können.

Hinweise

WMI ruft getObject häufig als Reaktion auf einen Clientaufruf von IWbemServices::GetObject auf. Die WMI-Version von Provider::GetObject stellt eine instance mit nur den aufgefüllten Schlüsseleigenschaften bereit. Im Gegensatz dazu muss ein implementierter Frameworkanbieter alle anderen Eigenschaften ausfüllen. Im Folgenden wird eine allgemeine Außerkraftsetzung von GetObject beschrieben:

1. Ermitteln Sie, welche instance WMI angefordert wird, indem Sie die Schlüsseleigenschaften mit einer Get-Methode aus CInstance lesen, z. B. CInstance::GetCHString.
2. Füllen Sie die restlichen Eigenschaften der instance mit den vielen Set-Methoden der CInstance-Klasse, z. B. CInstance::SetByte oder CInstance::SetStringArray.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	provider.h (schließen Sie FwCommon.h ein)
Bibliothek	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll