Functions
void	ATNds_free (void *ptr)
	Free a buffer which has been returned by ATNds_AFTN2AMHS or ATNds_AMHS2AFTN. More...

DS_Status	ATNds_AFTN2AMHS (DS_Session session, const DS_DN registry_dn, const char aftn_addr, char orbuf_p, size_t orbuf_len_p, DS_DN **userdn_p)
	Convert an AFTN address to the AMHS O/R address. If the user has an associated directory entry the distinguished name of that is returned as well. More...

DS_Status	ATNds_AMHS2AFTN (DS_Session session, const DS_DN registry_dn, const char x400_or_addr, char aftn_buf, DS_DN **userdn_p)
	Return the AFTN address associated with the given AMHS O/R address. If the user has an associated directory entry the distinguished name of this is returned as well. More...

Detailed Description

Functions of the ATN directory service client API.

Function Documentation

◆ ATNds_free()

void ATNds_free ( void * ptr )

Free a buffer which has been returned by ATNds_AFTN2AMHS or ATNds_AMHS2AFTN.

Parameters

ptr	[in] Pointer to buffer to free.

Returns: None

Examples: atnds_test.c.

◆ ATNds_AFTN2AMHS()

DS_Status ATNds_AFTN2AMHS	(	DS_Session *	session,
		const DS_DN *	registry_dn,
		const char *	aftn_addr,
		char **	orbuf_p,
		size_t *	orbuf_len_p,
		DS_DN **	userdn_p
	)

Convert an AFTN address to the AMHS O/R address. If the user has an associated directory entry the distinguished name of that is returned as well.

Parameters

session	[in] An open directory session.
registry_dn	[in] DN of ICAO or local registry.
aftn_addr	[in] AFTN address to convert.
orbuf_p	[out] Returned O/R address string, or NULL if the address could not be found.
orbuf_len_p	[out] Length of returned buffer, or 0 if the address could not be found.
userdn_p	[out] Returned DN (of user entry). NULL if none found.

Returns: DS_E_NOERROR on success or non-zero error code.

Note that DS_E_NOERROR can still be returned when the address could not be found.

Examples: atnds_test.c.

◆ ATNds_AMHS2AFTN()

DS_Status ATNds_AMHS2AFTN	(	DS_Session *	session,
		const DS_DN *	registry_dn,
		const char *	x400_or_addr,
		char *	aftn_buf,
		DS_DN **	userdn_p
	)

Return the AFTN address associated with the given AMHS O/R address. If the user has an associated directory entry the distinguished name of this is returned as well.

Parameters

session	[in] An open directory session.
registry_dn	[in] DN of ICAO or local registry.
x400_or_addr	[in] X400 O/R address to convert.
aftn_buf	[out] A buffer of length 9 which will hold the returned AFTN address. This buffer is allocated and owned by the caller.
userdn_p	[out] Returned DN (of user entry).

Returns: DS_E_NOERROR on success or non-zero error code.

Examples: atnds_test.c.