auth_destroy()--Destroy Authentication Information
Syntax
#include <rpc/rpc.h> void auth_destroy(AUTH *auth);
Default Public Authority: *USE
Service Program Name: QZNFTRPC
Threadsafe: No
The auth_destroy() function destroys the authentication information structure that is pointed to by the auth parameter.
Parameters
- auth
- (Input)
- A pointer to the authentication information structure to be destroyed. By destroying the auth structure, you deallocate private data structures.
Authorities
No authorization is required.
Return Value
None.
Error Conditions
None.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPE3418 E | Possible APAR condition or hardware failure. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
Related Information
- authsys_create()--Create Authentication with OS Permission
- authnone_create()--Create Null Authentication
Example
The following example shows how auth_destroy() is used.
Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.
#include <stdio.h>
#include <rpc/rpc.h>
/* Define remote program number and version */
#define RMTPROGNUM (u_long)0x3fffffffL
#define RMTPROGVER (u_long)0x1
main()
{
CLIENT *clnt; /* The client handle */
/*
Create the client handle, and initialize the authentication in
the clnt->cl_auth struct
*/
clnt = clnt_create("RPCSERVER_HOST", RMTPROGNUM, RMTPROGVER,
"tcp");
if (clnt == (CLIENT *)NULL) {
printf("Could not create client\n");
exit(1);
}
...
/*
Destroy the authentication information associated with
clnt->cl_auth
*/
auth_destroy(clnt->cl_auth);
...
}
API introduced: V4R2
[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]