DmiSubscriptionNotice(3dmi)


DmiSubscriptionNotice -- subscribe to receive indications

Synopsis

#include <dmi2ind.h>

DmiErrorStatus_t DMI_API DmiSubscriptionNotice ( DmiUnsigned_t handle, DmiNodeAddress_t* sender, DmiBoolean_t expired, DmiRowData_t* rowData );

Description

In order to receive indications, a managing node must have subscribed for indications with a managed node. The process for doing this is basically the populating of a row in the SPIndicationSubscription table on the managed node. This can be accomplished using the DmiAddRow(3dmi) and DmiDeleteRow(3dmi) commands. See section 3.2 of the DMI Specification for a description of this mechanism.

Parameters


handle
(Input) An opaque ID returned to the application

sender
(Input) Address of the originating node

expired
(Input) False: Subscription expiration pending True: Subscription has expired

rowData
(Input) Information about this subscription. This will be the row information for the appropriate entry in the indication table defined by the ``SPIndicationSubscription'' group.

Return values


DMIERR_NO_ERROR

DMIERR_ILLEGAL_HANDLE

DMIERR_OUT_OF_MEMORY

DMIERR_INSUFFICIENT_PRIVILEGES

DMIERR_SP_INACTIVE

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 the Desktop Management Task Force. 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