CWbemProviderGlue::GetInstancePropertiesByPath method (wbemglue.h)
[The CWbemProviderGlue class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]
The GetInstancePropertiesByPath method retrieves the instance identified by a particular object path, with only the specified properties populated. The properties to be populated are named in a CHString array.
HRESULT GetInstancePropertiesByPath( LPCWSTR pszInstancePath, CInstance **ppInstance, MethodContext *pMethodContext, [ref] CHStringArray & csaProperties );
The object path to the instance to be returned. This parameter must point to a full path.
A pointer to a pointer to a new CInstance instance whose keys are those specified by pszInstancePath. The framework provider that performs the request is must release this pointer.
A pointer to the current context. A context must be provided to prevent deadlocks. Either use the context passed into the provider by Provider::EnumerateInstances or Provider::ExecQuery, or else obtain it from the instance using CInstance::GetMethodContext. This parameter must not be NULL.
An array that contains the names of the properties to be copied into the new instance.
Returns WBEM_S_NO_ERROR if the operation was successful, WBEM_E_OUT_OF_MEMORY if the operation failed due to lack of memory, or any other HRESULT error code.
This method makes use of partial-instance update operations to request only the specified properties of the specified object. This is the most efficient way to retrieve a specific instance when more properties than just the keys are required. Be aware that not all providers support partial-instance operations. In that case, the entire instance (including the keys) are populated. For more information, see Supporting Partial-Instance Operations.
In the current version of the provider framework, pszInstancePath must resolve to be an instance path on the same computer.
|Minimum supported client||Windows Vista|
|Minimum supported server||Windows Server 2008|
|Header||wbemglue.h (include FwCommon.h)|