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.

Syntax

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

Parameters

name

Name of the CInstance property retrieved.

pInstance

Buffer that receives the pointer to the embedded CInstance object.

pMethodContext

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.

Requirements