Function

CFSocketCopyRegisteredSocketSignature

Returns a socket signature registered with a CFSocket name server.

Declaration

CFSocketError CFSocketCopyRegisteredSocketSignature(const CFSocketSignature *nameServerSignature, CFTimeInterval timeout, CFStringRef name, CFSocketSignature *signature, CFDataRef *nameServerAddress);

Parameters

nameServerSignature

The socket signature for the name server. If NULL, this function contacts the default server, which is assumed to be a local process using TCP/IP to listen on the port number returned from CFSocketGetDefaultNameRegistryPortNumber. If nameServerSignature is incomplete, the missing values are replaced with the default server’s values, if appropriate.

timeout

The time to wait for the server to accept a connection and to reply to the registration request.

name

The name of the registered socket signature to retrieve.

signature

A pointer to a CFSocketSignature structure into which the retrieved socket signature is copied.

nameServerAddress

A pointer to a CFData object into which the name server’s address is copied. Pass NULL if you do not want the server’s address.

Return Value

An error code indicating success or failure.

Discussion

Once you have the socket signature, you can open a connection to that socket with CFSocketCreateConnectedToSocketSignature.

See Also

Core Foundation Socket Name Server Utilities Miscellaneous Functions

CFSocketCopyRegisteredValue

Returns a value registered with a CFSocket name server.

CFSocketGetDefaultNameRegistryPortNumber

Returns the default port number with which to connect to a CFSocket name server.

CFSocketRegisterSocketSignature

Registers a socket signature with a CFSocket name server.

CFSocketRegisterValue

Registers a property-list value with a CFSocket name server.

CFSocketSetDefaultNameRegistryPortNumber

Sets the default port number with which to connect to a CFSocket name server.

CFSocketUnregister

Unregisters a value or socket signature with a CFSocket name server.