1MP_RegisterForObjeCcotmVmiosnibMiullittiypCahtahnMgMPea_snR(ae3ggMeiPmsAetPneItr)FLoirbOrbajreyctFVuinscitbiiolnistyChanges(3MPAPI)
2
3
4
6 MP_RegisterForObjectVisibilityChanges - register a client function to
7 be called
8
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
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
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
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
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
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)