Function

CFMessagePortGetContext

Returns the context information for a CFMessagePort object.

Declaration

void CFMessagePortGetContext(CFMessagePortRef ms, CFMessagePortContext *context);

Parameters

ms

The message port to examine.

context

A pointer to the structure into which the context information for ms is to be copied. The information being returned is usually the same information you passed to CFMessagePortCreateLocal when creating ms. However, if CFMessagePortCreateLocal returned a cached object instead of creating a new object, context is filled with information from the original message port instead of the information you passed to the function.

Discussion

The context version number for message ports is currently 0. Before calling this function, you need to initialize the version member of context to 0.

See Also

Examining a Message Port

CFMessagePortGetInvalidationCallBack

Returns the invalidation callback function for a CFMessagePort object.

CFMessagePortGetName

Returns the name with which a CFMessagePort object is registered.

CFMessagePortIsRemote

Returns a Boolean value that indicates whether a CFMessagePort object represents a remote port.

CFMessagePortIsValid

Returns a Boolean value that indicates whether a CFMessagePort object is valid and able to send or receive messages.