Direct Access Transport Library Functions dat_pz_free(3DAT)
NAME
dat_pz_free - destroy an instance of the Protection Zone
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include
DAT_RETURN
dat_pz_free (
IN DAT_PZ_HANDLE pz_handle
)PARAMETERS
pz_handle Handle for an instance of Protection Zone to be
destroyed.DESCRIPTION
The dat_pz_free() function destroys an instance of the Pro-
tection Zone. The Protection Zone cannot be destroyed if it is in use by an Endpoint, LMR, or RMR. Use of the handle of the destroyed Protection Zone in anysubsequent operation except for dat_pz_free() fails.
RETURN VALUES
DAT_SUCCESS The operation was successful.
DAT_INVALID_STATE Parameter in an invalid state. The
Protection Zone was in use by End-
point, LMR, or RMR instances.DAT_INVALID_HANDLE The pz_handle parameter is invalid.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:SunOS 5.11 Last change: 16 Jul 2004 1
Direct Access Transport Library Functions dat_pz_free(3DAT)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | Unsafe |
|_____________________________|_____________________________|
| Standard | uDAPL, 1.1, 1.2 ||_____________________________|_____________________________|
SEE ALSO
libdat(3LIB), attributes(5)SunOS 5.11 Last change: 16 Jul 2004 2