// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// Network interface (nif) APIs.

// This file contains all the Internal APIs required to implement a NIF for Symbian OS.

// 

//

/**

 @file nifif_internal.h

 @internalTechnology

 @released

*/

#if !defined(__NIFIF_INTERNAL_H__)

#define __NIFIF_INTERNAL_H__

#define SYMBIAN_NETWORKING_UPS

class CNifIfBase;

class CProtocolBase;

class MNifIfUser

/**

 * Interface between nifman and a layer 3 protocol

 * This interface is used by nifman to perform operations on the layer 3 protocol

 *

 * @internalTechnology

 * @released

 * @since v5.0

 */

	{

public:

	/**

	 *

	 */

	virtual void IfUserBindFailure(TInt aResult, TAny* aId)=0;

	/**

	 *

	 */

	virtual void IfUserNewInterfaceL(CNifIfBase* aIf, TAny* aId)=0;

	/**

	 *

	 */

	virtual void IfUserInterfaceDown(TInt aResult, CNifIfBase* aIf)=0;

	/**

	 *

	 */

	virtual void IfUserOpenNetworkLayer()=0;

	/**

	 *

	 */

	virtual void IfUserCloseNetworkLayer()=0;

	/**

	 *

	 */

	virtual CProtocolBase* IfUserProtocol()=0;

	/**

	 *

	 */

 	virtual TBool IfUserIsNetworkLayerActive()=0;

	};

/**

 * Option level for the nif - used with Get/SetOpt/Control/Ioctl methods

 *

 * @internalTechnology

 * @released

 * @since v5.0

 */

const TUint KNifOptLevel = 0x191;

/**

 * Options for controlling a nif through the RSocket::SetOption() and RSocket::GetOption() interface

 * @defgroup RSocketSetGetOptoptions Options for use with RSocket::SetOption() and RSocket::GetOption()

 *

 * @internalTechnology

 * @released

 * @since v5.0

 */

//@{

const TUint KNifOptStartInterface = 1;		//< Start the specified nif by CObject-name using Nif::Start

const TUint KNifOptStopInterface = 2;		//< Stop the specified nif by CObject-name using Nif::Stop

const TUint KNifOptInterfaceProgress = 3;	//< Fetch the current progress from the interface by CObject-name using Nif::ProgressL()

//@}

/**

 * @internalComponent

 */

typedef TPckgBuf<MNifIfUser*> TNifIfUser;

#ifdef SYMBIAN_NETWORKING_UPS

/**

@internalTechnology

Special NetworkId value to pass in TSoIfConnectionInfo to indicate that the NetworkId

should be determined from the socket address.  This should only be issued in special

circumstances (see TCP/IP stack and ESock server for detailed comments).

*/

const TUint32 KNetworkIdFromAddress = -1;

#endif

#endif