.\" @(#)PEXCopySearchContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCopySearchContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCopySearchContext \- Copy Search Context
.SH SYNTAX
.LP
.IP void .4i
PEXCopySearchContext\^(\^Display *\fIdisplay\fP\^, unsigned long \fIvalue_mask\fP\^, PEXSearchContext \fIsrc_context\fP\^, PEXSearchContext \fIdst_context\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIvalue_mask\fP
A mask specifying which attributes are to be copied.
.TP
\fIsrc_context\fP
The resource identifier of the source search context.
.TP
\fIdst_context\fP
The resource identifier of the destination search context.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXCopySearchContext
.IX "Copy" "PEXCopySearchContext"
.IX "Search Context" PEXCopySearchContext
.LP
This function copies attributes from the source search context
to the destination search context resource.  Both must
already exist as valid search context resources.
Attributes indicated by the value mask are copied and the
remainder of the attributes are left unchanged.
The value mask is constructed by OR'ing together the following constants:

.nf
.RS
.B PEXSCPosition
.B PEXSCDistance
.B PEXSCCeiling
.B PEXSCModelClipFlag
.B PEXSCStartPath
.B PEXSCNormalList
.B PEXSCInvertedList
.RE
.fi
.SH DATA STRUCTURES
.LP
.nf
typedef  XID    PEXSearchContext;
.sp
.fi
.SH ERRORS
.TP
.SB BadPEXSearchContext
A specified search context resource identifier is invalid.
.TP
.SB BadValue
An invalid bit is set in the value mask.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateSearchContext (3)
.fi