classname_structname_read_handle

This function constructs a MCO_READ_ONLY handle to be used to read the elements of a structure, where the structure itself is an element of structhandle1 (nested structures). Structhandle1 may have been constructed within the scope of either a MCO_READ_ONLY or MCO_READ_WRITE transaction.

Prototype

 
    MCO_RET	structname_structname_read_handle(	/*IN*/ structname1 *structhandle1, 
                                /*OUT*/ structname2 *structhandle2  );
 

Arguments

structhandle1	A pointer to a structname1 handle
structhandle2	A pointer to a structname2 handle

Description

This function constructs a MCO_READ_ONLY handle to be used to read the elements of a structure, where the structure itself is an element of structhandle1 (nested structures). Structhandle1 may have been constructed within the scope of either a MCO_READ_ONLY or MCO_READ_WRITE transaction.

Return Codes

MCO_S_OK	The handle was constructed successfully
MCO_E_ACCESS	The transaction that the class handle is scoped to is MCO_READ_ONLY
MCO_E_EMPTYOPTIONAL	The classhandle is for an optional struct that has been erased or has not yet been allocated

Related Topics