authnone_create()--Create Null Authentication
Syntax
#include <rpc/rpc.h> AUTH *authnone_create();
Default Public Authority: *USE
Service Program Name: QZNFTRPC
Threadsafe: No
The authnone_create() function creates and returns a default RPC authentication handle that passes null authentication information with each remote procedure call.
Parameters
None.
Authorities
No authorization is required.
Return Value
| auth | Upon successful completion, this API returns a pointer to an RPC authentication handle. |
| NULL | authnone_create() was not successful. The errno variable is set to indicate the reason. |
Error Conditions
| [ENOMEM] | Storage allocation failed. |
| [EUNKNOWN] | Unknown System State. |
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPIA1B0 I | An authentication problem was encountered by one of the TI-RPC APIs. |
| 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
Example
The following example shows how authnone_create() 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 *client; /* client handle */
...
/* Create a null authentication */
client->cl_auth = authnone_create();
if (client->cl_auth == (AUTH *)NULL){
fprintf(stderr, "authnone_create failed!!\n");
exit(1);
}
...
}
API introduced: V4R2
[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]