DmiIndicationListenExt(3dmi)
DmiIndicationListenExt --
instruct client to listen for specific incoming indications
Synopsis
#include <clidmi.h>
DmiErrorStatus_t DMI_API DmiIndicationListenExt (
DmiString_t * rpcType,
DmiStringList_t * protList);
Description
DmiIndicationListenExt
tells the client front end to listen for incoming
indications for given RPC and transports.
In response to this call, the client front-end software
starts the specified indication server.
To receive indications, an application must start at least one indication
server. An application should call DmiIndicationListenExt
once only using RPC type ``onc''.
Incoming indications will be delivered from the Service Providers where
the application
subscribed with the specified RPC and one of the transports. The
indication server
forwards these indications to the application through the callback entry
points last set by the
DmiSetIndicationCallbacks(3dmi)
function.
The DmiIndicationListenExt function
returns to the caller immediately
after processing all
the instructions associated with this function. This function is
executed entirely by the
client and does not send any command to the Service Provider.
Parameters
rpcType-
(Input)
RPC type of the indication server.
protList-
(Input)
List of the indication server's transport types for the
specified RPC type.
Return values
DMIERR_NO_ERROR-
DMIERR_OUT_OF_MEMORY-
DMIERR_CFE_ALREADY_LISTENING-
DMIERR_CFE_NO_RPC_CLIENTS_LOADED-
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