-- IDL module extracted from ITU-T Q Suppl. 28 (12/1999)

	// File SPFEEUserInitial.idl
	#ifndef spfeeuserinitial_idl
	#define spfeeuserinitial_idl

	#include "SPFEECommonTypes.idl"
	#include "SPFEEAccessCommonTypes.idl"

	module SPFEEUserInitial {

	// requestAccess() types

	typedef string t_ProviderId;

	// inviteUserWithoutAccessSession() types


	enum t_AccessReplyCodes {
		SUCCESS,	// user agrees to initiate an access session
		DECLINE,	// user declines to initiate an access session
		FAILED,	// for some unknown reason
		FORBIDDEN	// authorisation failure
	};

	typedef SPFEECommonTypes::t_PropertyList t_AccessReplyProperties;

	struct t_AccessReply {
		t_AccessReplyCodes reply;
		t_AccessReplyProperties properties;
	};

	interface i_UserInitial
	{
	// behaviour
	// behaviourText 
	// "This interface is provided to allow a Provider to invite 
	// a user to a session outside of an access session; and request 
	// the establishment of an access session";
	// usage
	// " ";

		void requestAccess (
			in t_ProviderId providerId,
			out t_AccessReply reply
		);

		void inviteUserOutsideAccessSession (
			in t_ProviderId providerId,
			in SPFEEAccessCommonTypes::t_SessionInvitation invitation,
			out SPFEECommonTypes::t_InvitationReply reply
		);

		void cancelInviteUserOutsideAccessSession (
			in t_ProviderId providerId,
			in SPFEEAccessCommonTypes::t_InvitationId id
		) raises (
			SPFEEAccessCommonTypes::e_InvitationError
		);

	};   // i_UserInitial
	};
	#endif