dat_pz_free(3DAT) 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/udat.h>
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 Protection Zone. The Protection Zone cannot be destroyed if it is in use by an End-
point, LMR, or RMR.
Use of the handle of the destroyed Protection Zone in any subsequent 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 Endpoint, LMR, or RMR instances.
DAT_INVALID_HANDLE The pz_handle parameter is invalid.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard: uDAPL, 1.1, 1.2 |
+-----------------------------+-----------------------------+
|MT-Level |Unsafe |
+-----------------------------+-----------------------------+
SEE ALSO
libdat(3LIB), attributes(5)
SunOS 5.10 16 Jul 2004 dat_pz_free(3DAT)
