DAT_PZ_FREE(3DAT) Direct Access Transport Library Functions

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
Endpoint, 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(7) 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(7)

July 16, 2004 DAT_PZ_FREE(3DAT)