1MP_GetTargetPortOiCdoLmimsotn(3MMuPlAtPiIp)ath Management LibMrPa_rGyetFTuanrcgteitoPnosrtOidList(3MPAPI)
2
3
4

NAME

6       MP_GetTargetPortOidList - get a list of  target  port object IDs
7

SYNOPSIS

9       cc [ flag... ] file... -lMPAPI [ library... ]
10       #include <mpapi.h>
11
12       MP_STATUS MP_GetTargetPortOidList(MP_OID oid,
13            MP_OID_LIST **ppList);
14
15

PARAMETERS

17       oid       The object ID of the target port group.
18
19
20       ppList    A  pointer  to  a  pointer  to  an  object  ID  that has type
21                 MP_OID_LIST structure. With a successful  return,  this  con‐
22                 tains  a  pointer  to  an object ID that has type MP_OID_LIST
23                 that contains the object IDs of all the target ports  associ‐
24                 ated with the specified target port group oid.
25
26

DESCRIPTION

28       The MP_GetTargetPortOidList() function returns a list of the object IDs
29       of the target ports  in the specified target port group.
30
31
32       When the caller is finished using the list it must free the memory used
33       by the list by calling MP_FreeOidList.
34

RETURN VALUES

36       MP_STATUS_INVALID_OBJECT_TYPE
37
38           The oid does not specify any valid object type. This is most likely
39           to happen if an uninitialized object ID is passed to the API.
40
41
42       MP_STATUS_INVALID_PARAMETER
43
44           The ppList is null or specifies a memory area to which data  cannot
45           be  written,  or  when  the  oid  has  a  type  subfield other than
46           MP_OBJECT_TYPE_TARGET_PORT.
47
48
49       MP_STATUS_OBJECT_NOT_FOUND
50
51           The oid owner ID or object sequence number  is invalid.
52
53
54       MP_STATUS_SUCCESS
55
56           The operation is successful.
57
58
59       MP_STATUS_FAILED
60
61           The target port group for the specified object ID is not found.
62
63
64       MP_STATUS_INSUFFICIENT_MEMORY
65
66           A memory allocation failure occurred.
67
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Standard: ANSI  INCITS  412  │
79       │                             │Multipath Management API     │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │MT-Level                     │Safe                         │
82       └─────────────────────────────┴─────────────────────────────┘
83

SEE ALSO

85       libMPAPI(3LIB), MP_GetTargetPortProperties(3MPAPI), attributes(5)
86
87
88       Multipath Management API Version 1.0
89
90
91
92SunOS 5.11                        15 Feb 2006  MP_GetTargetPortOidList(3MPAPI)
Impressum