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.