Freigeben über


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