---
name: "XmTransferSetParameters"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmTransferSetParameters"
---

# XmTransferSetParameters(3)

A toolkit function that establishes parameters to be passed by the next call to XmTransferValue

## NAME

**XmTransferSetParameters** — A toolkit function that establishes parameters to be passed by the next call to XmTransferValue

## SYNOPSIS

```
#include <Xm/Transfer.h>

void XmTransferSetParameters(
XtPointer transfer_id,
XtPointer parm,
int parm_fmt,
unsigned long parm_length,
Atom parm_type);
```

## DESCRIPTION

**XmTransferSetParameters** establishes a parameter definition. Your application calls **XmTransferSetParameters** just before calling **XmTransferValue**, and only if **XmTransferValue** needs to transfer a value containing a parameter.

- **transfer\_id**

  Specifies a unique indentifier for the data transfer operation. The value must be the same as the value of the **transfer\_id** member of the **XmDestinationCallbackStruct** passed to the **XmNdestinationCallback** procedure.

- *parm*

  Specifies parameters to be passed to the conversion routine (and the **XmNconvertCallback** procedures, if any) of the widget that owns the selection. The type and length of parameters are target-specific. If the target takes no parameters, the value is NULL.

- *parm\_fmt*

  Specifies whether the data in *parm* should be viewed as a list of 8-bit, 16-bit, or 32-bit quantities. Possible values are 0 (when *parm* is NULL), 8, 16, and 32.

- *parm\_length*

  Specifies the number of elements of data in *parm*, where each element has the number of bits specified by *parm\_fmt*. When *parm* is NULL, the value is 0.

- *parm\_type*

  Specifies the type of *parm*.

## RELATED

[**XmTransferSendRequest**(3)](/XmTransferSendRequest/3.md), [**XmTransferStartRequest**(3)](/XmTransferStartRequest/3.md), and [**XmTransferValue**(3)](/XmTransferValue/3.md).