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