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