MM_ReturnObjectProgenitor

Returns an IO object’s progenitor of a specific type.

Local Servers:Blocking
NetWare Server: 5.x
Platform:NLM
Service:Media Manager

Syntax

  LONG MM_ReturnObjectProgenitor (  
     OBID   progeny, 
     LONG   progenitorType, 
     OBID  *progenitor );

Parameters

progeny
The OBID of the object for which the progenitor object is desired.
progenitorType
The type of the IO object progenitor.
*progenitor
A pointer to where the progenitor’s OBID is placed, providing the progenitor exists.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

The progenitor was found and returned.

0x00000008

MM_OBJECT_NOT_FOUND

A progenitor of type progenitorType was not found.

Remarks

For IO objects with multiple parents the results are non-deterministic. The progenitor of the correct type is chosen arbitrarily in the case of multiple parents. Currently this is the case only with mirror objects.

See Also

Section 3.6, IO Class