DmiGetSubscriptionAddress(3dmi)


DmiGetSubscriptionAddress -- return the address of the indication server

Synopsis

#include <clidmi.h>

DmiErrorStatus_t DMI_API DmiGetSubscriptionAddress ( DmiString_t * rpcType, DmiString_t * transportType, DmiString_t ** address );

Description

DmiGetSubscriptionAddress returns the address of the indication server associated with the application, a given RPC and transport. This function requires that a local indication server was already started. Applications should use the DmiIndicationListen(3dmi) function to start the indication server before calling this function. The address returned by this function includes dynamic end-point information needed to differentiate among multiple indication consumers on the same machine. To provide the Service Provider with this information, an application should set the ``Subscriber Addressing'' field of the subscription and event filter rows to the retrieved address when subscribing for indications and events.

Parameters


rpcType
(Input) RPC type of the indication server. The only RPC types supported by this function are ``onc'' (ONC).

transportType
(Input) Transports available to the indication server. The function DmiListTransportTypes(3dmi) returns the run time list of available transports (see RPC Information Functions).

address
(Output) Pointer to a returned pointer to the indication server address string. The application is responsible for cleaning up the allocated memory. For example, the application can use the DmiFreeString(3dmi) function to clean up memory in a default memory model.

Return values


DMIERR_NO_ERROR

DMIERR_OUT_OF_MEMORY

DMIERR_CFE_FUNCTION_NOT_SUPPORTED

DMIERR_CFE_RPC_NOT_SUPPORTED

DMIERR_RPC_SERVER_UNAVAILABLE

DMIERR_RPC_TRANSPORT_UNAVAILABLE

DMIERR_RPC_LOW_RESOURCES

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.

Notices

Portions of this page are derived from material for which the copyright owner is Intel Corporation, Inc. The material is reprinted with permission. See copyright page for a full statement of rights and permissions.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004