1MP_RegisterForObjeCcotmVmiosnibMiullittiypCahtahnMgMPea_snR(ae3ggMeiPmsAetPneItr)FLoirbOrbajreyctFVuinscitbiiolnistyChanges(3MPAPI)
2
3
4

NAME

6       MP_RegisterForObjectVisibilityChanges  -  register a client function to
7       be called
8

SYNOPSIS

10       cc [ flag... ] file... -lMPAPI [ library... ]
11       #include <mpapi.h>
12
13       MP_STATUS MP_RegisterForObjectVisibilityChanges(
14            MP_OBJECT_PROPERTY_FN pClientFn, MP_OBJECT_TYPE objectType,
15            void *pCallerData, MP_OID pluginOid);
16
17

PARAMETERS

19       pClientFn      A pointer to an object ID that has type  MP_OBJECT_VISI‐
20                      BILITY_FN  function  defined by the client. With a  suc‐
21                      cessful return, this function is called  to  inform  the
22                      client  of  objects that have had one or more properties
23                      changed.
24
25
26       objectType     The type of object the client  wishes  to  register  for
27                      property change callbacks.
28
29
30       pCallerData    A  pointer  that  is passed to the callback routine with
31                      each event. This might be used by the caller  to  corre‐
32                      late the event to the source of the registration.
33
34
35       pluginOid      If  this  is a valid plugin object ID, then registration
36                      is limited to that plugin. If this  is  zero,  then  the
37                      registration is for all plugins.
38
39

DESCRIPTION

41       The MP_RegisterForObjectVisibilityChanges() function registers a client
42       function to be called whenever the property of an object  changes.  The
43       function  specified  by  pClientFn is called whenever objects appear or
44       disappear.
45
46
47       It is not an error to re-register a client function. However, a  client
48       function  has  only  one  registration.  The first call to deregister a
49       client function will deregister it no matter how many calls to register
50       the function have been made.
51

RETURN VALUES

53       MP_STATUS_INVALID_OBJECT_TYPE
54
55           The pluginOid or objectType does not specify any valid object type.
56           This is most likely to happen if  an  uninitialized  object  ID  is
57           passed to the API.
58
59
60       MP_STATUS_OBJECT_NOT_FOUND
61
62           The pluginOid owner ID or object sequence number is invalid.
63
64
65       MP_STATUS_INVALID_PARAMETER
66
67           The  pCallerData  is  null  or if the pluginOid has a type subfield
68           other than MP_OBJECT_TYPE_PLUGIN, or when objectType is invalid.
69
70
71       MP_STATUS_SUCCESS
72
73           The operation is successful.
74
75
76       MP_STATUS_FN_REPLACED
77
78           An existing client function is replaced with the one  specified  in
79           pClientFn.
80
81

ATTRIBUTES

83       See attributes(5) for descriptions of the following attributes:
84
85
86
87
88       ┌─────────────────────────────┬─────────────────────────────┐
89       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
90       ├─────────────────────────────┼─────────────────────────────┤
91       │Interface Stability          │Standard:  ANSI  INCITS 412  │
92       │                             │Multipath Management API     │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │MT-Level                     │Safe                         │
95       └─────────────────────────────┴─────────────────────────────┘
96

SEE ALSO

98       libMPAPI(3LIB),        MP_DeregisterForObjectVisibilityChanges(3MPAPI),
99       attributes(5)
100
101
102       Multipath Management API Version 1.0
103
104
105
106SunOS 5.11                       M1P5_RFeegbis2t0e0r6ForObjectVisibilityChanges(3MPAPI)
Impressum