1MP_GetAssociatedTPCGoOmimdoLnisMtu(l3tMiPpAaPtIh)ManagementMLPi_bGreatrAyssFoucnicattieodnTsPGOidList(3MPAPI)
2
3
4

NAME

6       MP_GetAssociatedTPGOidList - get a list of the object IDs
7

SYNOPSIS

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

PARAMETERS

17       oid       The object ID of the multipath logical unit.
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  will
22                 contain  a  pointer to an object ID that has type MP_OID_LIST
23                 that contains the object IDs of target port groups associated
24                 with the specified logical unit.
25
26

DESCRIPTION

28       The MP_GetAssociatedTPGOidList() function gets a list of the object IDs
29       containing the target port group associated with the  specified  multi‐
30       path logical unit.
31
32
33       When  the  caller  is  finished using the list, it must free the memory
34       used by the list by calling MP_FreeOidList.
35

RETURN VALUES

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

ATTRIBUTES

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

SEE ALSO

87       libMPAPI(3LIB), MP_GetTargetPortGroupProperties(3MPAPI), attributes(5)
88
89
90       Multipath Management API Version 1.0
91
92
93
94SunOS 5.11                        15 Feb 2006MP_GetAssociatedTPGOidList(3MPAPI)
Impressum