CInstance::GetEmbeddedObject method (instance.h)

[The CInstance 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 GetEmbeddedObject method retrieves a pointer to an embedded CInstance object. The pointer can be used to get and set properties of that embedded object.


bool GetEmbeddedObject(
  LPCWSTR       name,
  CInstance     **pInstance,
  MethodContext *pMethodContext



Name of the CInstance property retrieved.


Buffer that receives the pointer to the embedded CInstance object.


Additional information communicated to the provider.

Return value

Returns TRUE if the operation was successful and FALSE if an attempt was made to retrieve a property that is not a CInstance-compatible type or a property that does not exist. More information is available in the log file, Framework.log.


Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header instance.h (include FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll