MrmFetchLiteral - Fetches a literal from a UID file
int MrmFetchLiteral(hierarchy_id, index, display, value, type)
The MrmFetchLiteral function reads and returns the
value and type of a literal (named value) that is stored as a public
resource in a single UID file. This function returns a pointer to the
value of the literal. For example, an integer is always returned as a
pointer to an integer, and a string is always returned as a pointer to
Applications should not use MrmFetchLiteral for
fetching icon or color literals. If this is attempted,
MrmFetchLiteral returns an error.
- Specifies the ID of the UID
hierarchy that contains the specified literal. The
hierarchy_id was returned in a previous call to MrmOpenHierarchyPerDisplay.
- Specifies the UIL
name of the literal (pixmap) to fetch. You must define this name in
UIL as an exported value.
- Specifies the display used for the pixmap.
The display argument specifies the connection to the X
server. For more information on the Display
structure see the Xlib function XOpenDisplay.
- Returns the ID of the named literal's value.
- Returns the named literal's data type. Types
are defined in the include file
This function returns one of these status return constants:
The function executed successfully.
The hierarchy ID was invalid.
The literal was not found in the UIL file.
The caller tried to fetch a literal of a type not supported by this
The function failed.