Function

CFMessagePortInvalidate

Invalidates a CFMessagePort object, stopping it from receiving or sending any more messages.

Declaration

void CFMessagePortInvalidate(CFMessagePortRef ms);

Parameters

ms

The message port to invalidate.

Discussion

Invalidating a message port prevents the port from ever sending or receiving any more messages; the message port is not deallocated, though. If the port has not already been invalidated, the port’s invalidation callback function is invoked, if one has been set with CFMessagePortSetInvalidationCallBack. The CFMessagePortContext info information for ms is also released, if a release callback was specified in the port’s context structure. Finally, if a run loop source was created for ms, the run loop source is also invalidated.

See Also

Using a Message Port

CFMessagePortSendRequest

Sends a message to a remote CFMessagePort object.

CFMessagePortSetDispatchQueue

Schedules callbacks for the specified message port on the specified dispatch queue.