m_getvalues_layout(3LAYLayout Service Library Functm_getvalues_layout(3LAYOUT)NAMEm_getvalues_layout - query layout values of a LayoutObject
SYNOPSIS
cc [ flag... ] file... -llayout [ library... ]
#include <sys/layout.h>
int m_getvalues_layout(const LayoutObject layout_object, LayoutValues
values, int *index_returned);
DESCRIPTION
The m_getvalues_layout() function queries the current setting of layout
values within a LayoutObject.
The layout_object argument specifies a LayoutObject returned by the
m_create_layout(3LAYOUT) function.
The values argument specifies the list of layout values that are to be
queried. Each value element of a LayoutValueRec must point to a loca‐
tion where the layout value is stored. That is, if the layout value is
of type T, the argument must be of type T*. The values are queried from
the LayoutObject and represent its current state.
It is the user's responsibility to manage the space allocation for the
layout values queried. If the layout value name has QueryValueSize OR-
ed to it, instead of the value of the layout value, only its size is
returned. The caller can use this option to determine the amount of
memory needed to be allocated for the layout values queried.
RETURN VALUES
Upon successful completion, the m_getvalues_layout() function returns
0. If any value cannot be queried, the index of the value causing the
error is returned in index_returned, −1 is returned and errno is set to
indicate the error.
ERRORS
The m_getvalues_layout() function may fail if:
EINVAL The layout value specified by index_returned is
unknown, its value is invalid, or the layout_object
argument is invalid. In the case of an invalid lay‐
out_object argument, the value returned in
index_returned is −1.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOm_create_layout(3LAYOUT), attributes(5)SunOS 5.10 8 Jun 1999 m_getvalues_layout(3LAYOUT)