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

NAME

       dat_get_handle_type - get handle type

SYNOPSIS

       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       DAT_RETURN
	   dat_get_handle_typet (
	   IN	 DAT_HANDLE	   dat_handle,
	   OUT	 DAT_HANDLE_TYPE   *handle_type
	   )

PARAMETERS

       dat_handle      Handle for a DAT Object.

       handle_type     Type of the handle of dat_handle.

DESCRIPTION

       The dat_get_handle_type() function allows the Consumer to discover the type of a DAT Object using its handle.

       The  dat_handle	can  be  one  of  the following handle types: DAT_IA_HANDLE, DAT_EP_HANDLE, DAT_EVD_HANDLE, DAT_CR_HANDLE, DAT_RSP_HANDLE,
       DAT_PSP_HANDLE, DAT_PZ_HANDLE, DAT_LMR_HANDLE, or DAT_RMR_HANDLE.

       The handle_type is one of the following handle  types:  DAT_HANDLE_TYPE_IA,  DAT_HANDLE_TYPE_EP,  DAT_HANDLE_TYPE_EVD,  DAT_HANDLE_TYPE_CR,
       DAT_HANDLE_TYPE_PSP, DAT_HANDLE_TYPE_RSP, DAT_HANDLE_TYPE_PZ, DAT_HANDLE_TYPE_LMR, DAT_HANDLE_TYPE_RMR, or DAT_HANDLE_TYPE_CNO.

RETURN VALUES

       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_HANDLE      The dat_handle parameter is invalid.

USAGE

       Consumers  can  use  this  operation to determine the type of Object being returned. This is needed for calling an appropriate query or any
       other operation on the Object handle.

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_get_handle_type(3DAT)