netdir_free()--Free Netdir Structures

Syntax

 #include <netdir.h>

 void netdir_free(void *ptr,
                  int struct_type);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The netdir_free() function frees structures that are allocated by name-to-address translation APIs.

ptr (Input)

A pointer to a structure that is to be freed.

struct_type (Input)

The integer value that indicates to netdir_free() which type of structure to be freed.

The following combination is supported:

ND_HOSTSERV	A pointer to an nd_hostserv structure.
ND_HOSTSERVLIST	A pointer to an nd_hostservlist structure.
ND_ADDR	A pointer to a netbuf structure.
ND_ADDRLIST	A pointer to an nd_addrlist structure.

No authorization is required.

If netdir_free() takes an exception, nd_errno is set to the following error:

[ND_SYSTEM]

A damaged object was encountered. The damaged object cannot be used.

Message ID	Error Message Text
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

netdir_free() frees the structure allocated by the netdir APIs. The type of structure to be freed is indicated by the struct_type.

Refer to other name-to-address translation functions to see how netdir_free() function is used.

API introduced: V4R2