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 classname. Classhandle may have been constructed within the scope of either a MCO_READ_ONLY or MCO_READ_WRITE transaction.

Prototype

 
    MCO_RET	classname_structname_read_handle(	/*IN*/ classname *classhandle, 
                               /*OUT*/ structname *structhandle  );
 

Arguments

classhandle	A pointer to a classname handle
structhandle	A pointer to a structname 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 classname. Classhandle 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