krb5_auth_con_getports()--Get Local and Remote Network Ports
Syntax
#include <krb5.h> krb5_error_code krb5_auth_con_getports( krb5_context context, krb5_auth_context auth_context, krb5_address ** local_port, krb5_address ** remote_port);Service Program Name: QSYS/QKRBGSS
Default Public Authority: *USE
Threadsafe: Conditional. See Usage Notes.
The krb5_auth_con_getports() function retrieves the local and remote network ports stored in the authentication context.
Authorities
No authorities are required.
Parameters
- context (Input)
- The Kerberos context.
- auth_context (Input)
- The authentication context.
- local_port (Output)
- The local network port. Specify NULL for this parameter if
the local network port is not required. The return value is
NULL if the local network port has not been set. The
krb5_free_address() routine should be called to release the
address when it is no longer needed.
- remote_port (Output)
- The remote network port. Specify NULL for this parameter if the remote network port is not required. The return value is NULL if the remote network port has not been set. 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. |
Usage Notes
- The Kerberos protocol runtime provides no concurrency control for the authentication context. If the application wants to use the same authentication context in multiple threads, it is the responsibility of the application to serialize access to the authentication context so that only a single thread is accessing the authentication context at any time.
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]