freenetconfigent()--Free the Netconfig Structure
Syntax
#include <netconfig.h> void freenetconfigent(struct netconfig *);
Service Program Name: QZNFTRPC
Default Public Authority: *USE
Threadsafe: No
The freenetconfigent() function frees the netconfig structure that is returned from the call to the getnetconfigent() function.
Parameters
- netconfig (Input)
- A pointer to a netconfig structure that is set by a call to the setnetconfig() function.
Authorities
No authorization is required.
Return Value
None.
Error Conditions
If an exception occurs, freenetconfigent() fails to free the netconfig structure. If freenetconfigent() is not successful, errno indicates the following error.
[EUNKNOWN] | Unknown system state.
The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are indicated. Then retry the operation. |
Error Messages
Message ID | Error Message Text |
---|---|
CPF3CF2 E | Error(s) occurred during running of &1 API. |
CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
Example
The following example shows how freenetconfigent() is used.
Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.
#include <netconfig.h> main() { struct netconfig *nconf; /* Assuming UDP is a netid on the system, get the netconfig structure * if ((nconf = getnetconfigent("UDP")) == (struct netconfig *)NULL) { printf("There is no information about UDP\n"); exit(1); } /* Print out the information associated with the transport */ /* identified with the netid of UDP */ printf("Transport provider name: %s\n", nconf->nc_netid); switch(nconf->nc_semantics) { case NC_TPI_CLTS: printf("Transport type name: TPI_CLTS\n"); break; case NC_TPI_COTS: printf("Transport type name: TPI_COTS\n"); break; case NC_TPI_COTS_ORD: printf("Transport type name: TPI_COTS_ORD\n"); break; default: break; } switch(nconf->nc_flag) { case 0: printf("Transport flag name: N\n"); break; case 1: printf("Transport flag name: V\n"); break; default: break; } printf("Transport family name: %s\n", nconf->nc_protofmly); printf("Transport protocol name: %s\n", nconf->nc_proto); /* Free the netconfig structure returned by getnetconfigent() */ freenetconfigent(nconf); }
API introduced: V4R2
[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]