Function

Purpleupnp_remove_port_mapping

Declaration [src]

PurpleUPnPMappingAddRemove*
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

Parameters

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.