Digital

NAME

X25UnbindFilter − Disassociates a filter from an X.25 listener

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x25.h>
int X25UnbindFilter(

int ld ,
char ∗ filter );

PARAMETERS

ldIdentifies the listener from which the filter is to be disassociated. 

filterPoints to a null-terminated string containing the name of the filter to be disassociated from the listener. 
 

DESCRIPTION

 
The X25UnbindFilter routine deletes a filter from the list of filters on the X.25 listener that calls are matched against. 
 

RETURN VALUES

Upon successful completion, the X25UnbindFilter routine returns a value of 0.  Otherwise, a (negative) error code is returned. 
 
 

ERRORS

 
If the X25UnbindFilter routine fails, one of the following error codes is returned:

[X25RC_BADLD]
Invalid listener descriptor specified.

[X25RC_FILTERDEL]
One or more filters associated with this listener have been deleted by network management commands.  If the specified filter still exists, the X25UnbindFilter routine should be called again to disassociate it from the specified listener. 

[X25RC_FNOTBOUND]
The requested filter is not currently associated with the specified listener.

[X25RC_LASTFILTER]
All filters associated with this listener have been deleted by network management commands.  There are no filters to be disassociated from the specified listener.

[X25RC_NOFILTER]
The specified filter does not exist.

[X25RC_NOMEM]
There were insufficient system resources to perform the requested operation.  The filter was not disassociated from the listener.

[X25RC_SERVICEDOWN]
The X.25 service is not available because an entity is not in the correct state.  Either the X25 Access entity is disabled, or the X25 Protocol entity does not exist.

[X25RC_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 
 

RELATED INFORMATION

Functions: X25BindFilter(3X25), X25CreateListener(3X25), X25Listen(3X25), X25MakeCall(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.