CWbemProviderGlue::GetInstancePropertiesByPath-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 GetInstancePropertiesByPath-Methode ruft die durch einen bestimmten Objektpfad identifizierte instance ab, wobei nur die angegebenen Eigenschaften aufgefüllt werden. Die auffüllenden Eigenschaften werden in einem CHString-Array benannt.
Syntax
HRESULT GetInstancePropertiesByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext,
[ref] CHStringArray & csaProperties
);
Parameter
pszInstancePath
Der Objektpfad zum zurückzugebenden instance. Dieser Parameter muss auf einen vollständigen Pfad verweisen.
ppInstance
Ein Zeiger auf einen Zeiger auf eine neue CInstance-instance deren Schlüssel die von pszInstancePath angegebenen sind. Der Frameworkanbieter, der die Anforderung ausführt, muss diesen Zeiger freigeben.
pMethodContext
Ein Zeiger auf den aktuellen Kontext. Ein Kontext muss 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 aus dem instance ab. Dieser Parameter darf nicht NULL sein.
[ref] csaProperties
Ein Array, das die Namen der Eigenschaften enthält, die in die neue instance kopiert werden sollen.
Rückgabewert
Gibt WBEM_S_NO_ERROR zurück, wenn der Vorgang erfolgreich war, WBEM_E_OUT_OF_MEMORY , wenn der Vorgang aufgrund fehlenden Arbeitsspeichers oder eines anderen HRESULT-Fehlercodes fehlgeschlagen ist.
Hinweise
Diese Methode verwendet teilweise instance Aktualisierungsvorgänge, um nur die angegebenen Eigenschaften des angegebenen Objekts anzufordern. Dies ist die effizienteste Methode zum Abrufen einer bestimmten instance, wenn mehr Eigenschaften als nur die Schlüssel erforderlich sind. Beachten Sie, dass nicht alle Anbieter teilweise instance Vorgänge unterstützen. In diesem Fall werden die gesamten instance (einschließlich der Schlüssel) 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 (schließen Sie FwCommon.h ein) |
| Bibliothek | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |