DAT_RSP_FREE(3DAT) Direct Access Transport Library Functions

NAME

dat_rsp_free - destroy an instance of the Reserved Service Point

SYNOPSIS

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

DAT_RETURN
dat_rsp_free (
IN DAT_RSP_HANDLE rsp_handle
)

PARAMETERS

rsp_handle
Handle for an instance of the Reserved Service Point.

DESCRIPTION

The dat_rsp_free() function destroys a specified instance of the
Reserved Service Point.


Any incoming Connection Requests for the Connection Qualifier on the
destroyed Service Point was listening on are automatically rejected
by the Provider with the return analogous to the no listening Service
Point.


The behavior of the Connection Requests in progress is undefined and
left to an implementation, but it must be consistent. This means that
either a Connection Requested Event was generated for the Event
Dispatcher associated with the Service Point, including the creation
of the Connection Request instance, or the Connection Request is
rejected by the Provider without any local notification.


This operation has no effect on previously generated Connection
Request Event and Connection Request.


The behavior of this operation with creation of a Service Point on
the same Connection Qualifier at the same time is not defined.
Consumers are advised to avoid this scenario.


For the Reserved Service Point, the Consumer-provided Endpoint
reverts to Consumer control. Consumers shall be aware that due to a
race condition, this Reserved Service Point might have generated a
Connection Request Event and passed the associated Endpoint to a
Consumer in it.


Use of the handle of the destroyed Service Point in any consequent
operation fails.

RETURN VALUES

DAT_SUCCESS
The operation was successful.


DAT_INVALID_HANDLE
The rsp_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_RSP_FREE(3DAT)