ConnectToServer

- connect to a DMI service provider

Synopsis

cc [ flag ... ] file ... -ldmici -ldmimi   [ library ... ]
#include <dmi/api.hh>

bool_t ConnectToServer(ConnectI *argp, DmiRpcHandle *dmi_rpc_handle);

Description

The ConnectToServer() function enables a management application or a component instrumentation to connect to a DMI service provider.

The argp parameter is an input parameter that uses the following data structure:

struct ConnectIN {
        char        *host;
        const char  *nettype;
        ServerType  servertype;
        RpcType     rpctype;
}

The host member indicates the host on which the service provider is running. The default is localhost.

The nettype member specifies the type of transport RPC uses. The default is netpath.

The servertype member indicates whether the connecting process is a management application or a component instrumentation.

The rpctype member specifies the type of RPC, either ONC or DCE. Only ONC is supported in the Solaris 7 release.

The dmi_rpc_handle parameter is the output parameter that returns DMI RPC handle.

Return Values

The ConnectToServer() function returns TRUE if successful, otherwise FALSE.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

DisconnectToServer(3DMI),attributes(5)