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.