Moving a channel
| Interacting with the server |

### Moving a channel

To move a channel to a new parent channel, call

`unsigned int ts3client_requestChannelMove(` | serverConnectionHandlerID, |
| channelID, |
| newChannelParentID, |
| newChannelOrder, |
| returnCode`)`; |

`anyID serverConnectionHandlerID`;
`anyID channelID`;
`anyID newChannelParentID`;
`anyID newChannelOrder`;
`const char* returnCode`;

Parameters

- `serverConnectionHandlerID`

  ID of the server connection handler on which the channel should be moved.

- `channelID`

  ID of the channel to be moved.

- `newChannelParentID`

  ID of the parent channel where the moved channel is to be inserted as child. Use `0` to insert as top-level channel.

- `newChannelOrder`

  Channel order defining where the channel should be sorted under the new parent. Pass 0 to sort the channel right after the parent. See the chapter Channel sorting for details.

- `returnCode`

  See return code documentation. Pass NULL if you do not need this feature.

Returns `ERROR_ok` on success, otherwise an error code as defined in `public_errors.h`.

After sending the request, the following event will be called if the move was successful:

`void onChannelMoveEvent(` | serverConnectionHandlerID, |
| channelID, |
| newChannelParentID, |
| invokerID, |
| invokerName, |
| invokerUniqueIdentifier`)`; |

`anyID serverConnectionHandlerID`;
`anyID channelID`;
`anyID newChannelParentID`;
`anyID invokerID`;
`const char* invokerName`;
`const char* invokerUniqueIdentifier`;

Parameters

- `serverConnectionHandlerID`

  ID of the server connection handler on which the channel was moved.

- `channelID`

  The ID of the moved channel.

- `newChannelParentID`

  ID of the parent channel where the moved channel is inserted as child. `0` if inserted as top-level channel.

- `invokerID`

  The ID of the client who requested the move. If zero, the move was initiated by the server.

- `invokerName`

  The name of the client who requested the move. Empty if requested by the server.

- `invokerUniqueIdentifier`

  The unique ID of the client who requested the move.

Deleting a channel |  | Text chat