Novell Documentation: Storage Architecture Components (incl. Media Manager & NWPA)

MM_ReturnObjectMappingInfo

Returns the object’s mapping as defined by the class.

Syntax

  LONG MM_ReturnObjectMappingInfo (  
     OBID   objectID, 
     LONG   class, 
     LONG   mappingInfoLength, 
     LONG  *mappingInfo );

objectID: The OBID of the object for which mapping information will be returned.

class: This identifies the class that will return the mapping information. The mapping information can be different across classes for the same objectID.

mappingInfoLength: The size, in bytes, of the mapping information as defined by the class.

The following table lists return values and descriptions.

0x00000000	MM_OK The mapping information was successfully obtained.
0x00000001	MM_INVALID_OBJECT objectID is invalid.
0x0000020B	MM_BUFFER_TOO_SMALL *mappingInfo is too small according to mappingInfoLength.
0x00000200	MM_DATABASE_ERROR A Media Manager database assertion regarding objectID is not true. The object is likely corrupted.

Get the objectID using MM_FindObjectType.

Get the mappingInfoLength from the appropriate GenericInfoDef structure using MM_ReturnObjectGenericInfo.

The *mappingInfo for an IO object points to IOObjectMappingTableDef structure. For more information, see IO Object Mapping.