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

See Code disclaimer information for information pertaining to code examples.

The following example shows how authnone_create() is used:

#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
Top | Remote Procedure Call (RPC) APIs | APIs by category