1dat_pz_free(3DAT)  Direct Access Transport Library Functions dat_pz_free(3DAT)
2
3
4

NAME

6       dat_pz_free - destroy an instance of the Protection Zone
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_pz_free (
14           IN    DAT_PZ_HANDLE    pz_handle
15           )
16
17

PARAMETERS

19       pz_handle    Handle for an instance of Protection Zone to be destroyed.
20
21

DESCRIPTION

23       The dat_pz_free() function destroys an instance of the Protection Zone.
24       The Protection Zone cannot be destroyed if it is in use by an Endpoint,
25       LMR, or RMR.
26
27
28       Use  of  the  handle of the destroyed Protection Zone in any subsequent
29       operation except for dat_pz_free() fails.
30

RETURN VALUES

32       DAT_SUCCESS           The operation was successful.
33
34
35       DAT_INVALID_STATE     Parameter in an  invalid  state.  The  Protection
36                             Zone   was  in  use  by  Endpoint,  LMR,  or  RMR
37                             instances.
38
39
40       DAT_INVALID_HANDLE    The pz_handle parameter is invalid.
41
42

ATTRIBUTES

44       See attributes(5) for descriptions of the following attributes:
45
46
47
48
49       ┌─────────────────────────────┬─────────────────────────────┐
50       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
51       ├─────────────────────────────┼─────────────────────────────┤
52       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
53       ├─────────────────────────────┼─────────────────────────────┤
54       │MT-Level                     │Unsafe                       │
55       └─────────────────────────────┴─────────────────────────────┘
56

SEE ALSO

58       libdat(3LIB), attributes(5)
59
60
61
62SunOS 5.11                        16 Jul 2004                dat_pz_free(3DAT)
Impressum