EPOC   SDK Home Glossary Indexes Previous Next Up

RNif class


Contents


RNif class — Network interface manager base

Section Contents


Overview

Derivation

RHandleBase

Abstract: handle to an object

RSessionBase

Abstract: session base class.

RNif

Abstract: base class for network interface manager

Defined in

nifman.h

Link against

nifman.lib


Dial-up progress notification service


ProgressNotification() — Issue request for current stage of a dial-up connection

void ProgressNotification(TNifProgressBuf& aProgress, TRequestStatus& aStatus);

Description

Use this function to request the current stage of a dial-up connection. This is an asynchronous request.

When the request completes, the iStage member function of the packaged TNifProgress object contains a value which defines the current stage. Where NetDial is the agent of the Network Interface Manager, the stage of the dial-up connection is defined by one of the TNetDialProgress enumerators.

If an outstanding request is cancelled by a call to CancelProgressNotification(), then the request completes and aStatus is set to KErrCancel.

See also asynchronous services.

Arguments

TNifProgressBuf& aProgress

A reference to a package buffer containing a TNifProgress object.

TRequestStatus& aStatus

A reference to the request status object.

If the request is cancelled, this is set to KErrCancel.


CancelProgressNotification() — Cancel outstanding request for current stage of a dial-up connection

void CancelProgressNotification();

Description

Use this function to cancel an outstanding request for the current stage of a dial-up connection.

The outstanding request completes with the request status set to KErrCancel.


Progress() — Poll for current stage of a dial-up connection

TInt Progress(TNifProgress& aProgress);

Description

Use this function to get the current stage of the dial-up connection. This is a synchronous request and is complete when the function returns.

When the function returns, the iStage member function of aProgress contains a value which defines the current stage. Where NetDial is the agent of the Network Interface Manager, the stage of the dial-up connection is defined by one of the TNetDialProgress enumerators.

Arguments

TNifProgress& aProgress

A reference to a TNifProgress object. On successful return, the iStage data member of this is object contains the current stage of the dial-up connection.

Return value

TInt

KErrNone if successful, otherwise one of the system error codes.


LastProgressError() — Poll for the last error in setting up the connection

TInt LastProgressError(TNifProgress& aProgress);

Description

Use this function to get the last error which occurred when setting up the connection. This is a synchronous request which is complete when the function returns.

Arguments

TNifProgress& aProgress

A reference to a TNifProgress object. On successful return, the iError data member of this object contains the last error which occurred.

Return value

TInt

KErrNone if successful, otherwise one of the system error codes.

EPOC       SDK Home Glossary Indexes Previous Next Up