CLIENT* register_idl_client(long server_id, char* hostname,
     struct timeval* timeout)  

Description

Call this function to register your program as a client of an IDL server. Note that a program can be the client of a number of different servers at the same time and a single server can have multiple clients.

Parameters

server_id

The ID number of the IDL server that the program is to be registered with. If this value is 0, the default server ID (0x2010CAFE) is used.

hostname

The name of the machine where the IDL server is running. If this value is NULL or "", the default, localhost, is used.

timeout

A pointer to the timeout value for all communication with IDL servers. If this value is NULL or 0, the default timeout, 60 seconds, is used.

Return Value

A pointer to the new CLIENT structure is returned. This function returns NULL if it is unsuccessful.

  IDL Online Help (March 06, 2007)