ConnectToServer(3DMI)					       DMI Library Functions					     ConnectToServer(3DMI)

NAME

       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:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       DisconnectToServer(3DMI),attributes(5)

SunOS 5.10							    4 Aug 1998						     ConnectToServer(3DMI)