MI_Deserializer_Class_GetParentClassName function (mi.h)

Gets the parent class name from a serialized class buffer.

Syntax

MI_INLINE MI_Result MI_Deserializer_Class_GetParentClassName(
  [in, out] MI_Deserializer *deserializer,
            MI_Uint8        *serializedBuffer,
            MI_Uint32       serializedBufferLength,
            MI_Char         *parentClassName,
  [in, out] MI_Uint32       *parentClassNameLength,
            MI_Instance     **cimErrorDetails
);

Parameters

[in, out] deserializer

A pointer to a deserializer object returned from a call to MI_Application_NewDeserializer. The deserializer must match the serializer that created the buffer.

serializedBuffer

A serialized buffer that was filled via a call from MI_Serializer_SerializeInstance.

serializedBufferLength

The length of the buffer that was reported via a call to MI_Serializer_SerializeInstance.

parentClassName

Returned parent class name. If this parameter is Null, the required buffer size is returned through the parentClassNameLength parameter.

[in, out] parentClassNameLength

A pointer to the length of the parentClassName buffer. If parentClassName is NULL, this parameter is filled in with the required length of the buffer needed.

cimErrorDetails

If the call fails, this value will contain information useful in debugging. This value must be deleted via MI_Instance_Delete.

Return value

This function returns MI_INLINE MI_Result.

Remarks

Not all serializers include enough information to retrieve this information, in which case the function will fail with a MI_RESULT_NOT_SUPPORTED error. If no parent exists, the function will return a MI_RESULT_NOT_FOUND error.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Windows
Header mi.h
Redistributable Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2