Declaration [src]

purple_upnp_remove_port_mapping (
  unsigned short portmap,
  const gchar* protocol,
  PurpleUPnPCallback cb,
  gpointer cb_data

Description [src]

Deletes a port mapping in a UPnP enabled IGD that sits on the local network to this purple client. Essentially, this function takes care of deleting the port forwarding after they have completed a connection so another client on the local network can take advantage of the port forwarding.

This function is not directly available to language bindings


portmap unsigned short

The port to delete the mapping for.

protocol const gchar*

The protocol to map to. Either “TCP” or “UDP

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
cb PurpleUPnPCallback

An optional callback function to be notified when the mapping removal is complete.

cb_data gpointer

Extra data to be passed to the callback.

 The argument can be NULL.
 The data is owned by the caller of the function.

Return value

Returns: PurpleUPnPMappingAddRemove

Data which can be passed to purple_upnp_cancel_port_mapping() to cancel.

 The caller of the function takes ownership of the data, and is responsible for freeing it.