endnetent_r()--Close Network Database

 #include <netdb.h>
 int endnetent_r(struct netent_data
                *netent_data_struct_addr)

The endnetent_r() function is used to close the network database file. The file is opened by those functions that retrieve information about a network (for example, getnetent_r()).

Parameters

struct netent_data *netent_data_struct_addr  (input) 

Specifies the pointer to the netent_data structure, which is used to pass and preserve results between function calls. The field net_control_blk in the netent_data structure must be initialized with hexadecimal zeros before its initial use. If compatibility with other platforms is required, then the entire netent_data structure must be initialized with hexadecimal zeros before initial use.

Authorities

No authorization is required.

Return Value

The endnetent_r() function returns an integer. Possible values are:

• -1 (unsuccessful call)
  
  
• 0 (successful call)

  The struct netent_datadenoted by netent_data_struct_addr is defined in <netdb.h>.

Error Conditions

When the endnetent_r() function fails, errno can be set to:

[EINVAL]

The netent_data structure was not properly initialized to hexadecimal zeros before initial use. For corrective action, see the description for structure netent_data.

Usage Notes

1. When the _XOPEN_SOURCE macro defined to the value 520 or greater, the network file is always closed. When the _XOPEN_SOURCE macro is not so defined, the network file will not be closed if a setnetent_r() call with a nonzero parameter value was previously done.
   
   
2. The iSeries Navigator or the following CL commands can be used to access the network database file:
   
   
   • WRKNETTBLE (Work with Network Table Entries)
   • ADDNETTBLE (Add Network Table Entry)
   • RMVNETTBLE (Remove Network Table Entry)
   
   
3. When you develop in C-based languages and an application is compiled with the _XOPEN_SOURCE macro defined to the value 520 or greater, the endnetent_r() API is mapped toqso_endnetent_r98().
   
   

Related Information

• _XOPEN_SOURCE--Using _XOPEN_SOURCE for the UNIX 98 compatible interface
  
  
• getnetent_r()--Get Next Entry from Network Database
  
  
• getnetbyaddr_r()--Get Network Information for IP Address
  
  
• getnetbyname_r()--Get Network Information for Domain Name
  
  
• setnetent_r()--Open Network Database