DAT_PZ_FREE(3DAT) Direct Access Transport Library Functions DAT_PZ_FREE(3DAT)

dat_pz_free - destroy an instance of the Protection Zone

cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>
DAT_RETURN
    dat_pz_free (
    IN    DAT_PZ_HANDLE    pz_handle
    )

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

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.

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.

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Standard: uDAPL, 1.1, 1.2
MT-Level Unsafe

libdat(3LIB), attributes(7)

July 16, 2004 OmniOS