# 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