CWbemProviderGlue::GetInstanceKeysByPath-Methode (wbemglue.h)
[Die CWbemProviderGlue-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und werden keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar sein, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]
Die GetInstanceKeysByPath-Methode ruft die durch einen bestimmten Objektpfad identifizierte instance ab, wobei nur die Schlüsseleigenschaften aufgefüllt werden.
Syntax
HRESULT GetInstanceKeysByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext
);
Parameter
pszInstancePath
Ein Objektpfad zum zurückzugebenden instance.
ppInstance
Ein Zeiger auf einen Zeiger auf einen neuen CInstance-instance dessen Schlüssel die im pszInstancePath angegebenen schlüssel sind. Der Frameworkanbieter, der die Anforderung ausführt, muss diesen Zeiger freigeben.
pMethodContext
Ein Zeiger auf den aktuellen Kontext. Es muss ein Kontext bereitgestellt werden, um Deadlocks zu verhindern. Verwenden Sie entweder den Kontext, der von Provider::EnumerateInstances oder Provider::ExecQuery an den Anbieter übergeben wird, oder rufen Sie ihn mithilfe von CInstance::GetMethodContext von der instance ab. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Gibt WBEM_S_NO_ERROR zurück, wenn der Vorgang erfolgreich war, WBEM_E_OUT_OF_MEMORY , wenn der Vorgang aufgrund von Arbeitsspeichermangel oder einem anderen HRESULT-Fehlercode fehlgeschlagen ist.
Hinweise
Diese Methode verwendet teilweise instance Aktualisierungsvorgänge, um nur die Schlüsseleigenschaften des angegebenen Objekts anzufordern. Dies ist die effizienteste Möglichkeit, das Vorhandensein eines bestimmten Objekts zu überprüfen. Beachten Sie, dass nicht alle Anbieter teilweise instance Vorgänge unterstützen. In diesem Fall wird der gesamte instance aufgefüllt. Weitere Informationen finden Sie unter Unterstützen von Partial-Instance-Vorgängen.
In der aktuellen Version des Anbieterframeworks muss pszInstancePath als instance Pfad auf demselben Computer aufgelöst werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wbemglue.h (einschließlich FwCommon.h) |
| Bibliothek | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |