krb5_copy_address()--Copy a Kerberos Address to a New Structure


  Syntax
 #include <krb5.h>

 krb5_error_code krb5_copy_address(
     krb5_context   context,
     krb5_const krb5_address *  from_addr,  
     krb5_address **    to_addr); 
  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_copy_address() function copies a Kerberos address to a new structure.


Authorities

No authorities are required.


Parameters

context  (Input)
The Kerberos context.

from_addr  (Input)
The address to be copied.

to_addr  (Output)
The new krb5_address structure. The krb5_free_address() routine should be called to release the address when it is no longer needed.


Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.


Error Messages

Message ID Error Message Text
CPE3418 E Possible APAR condition or hardware failure.



API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]