Edit

IMbnDeviceService::OpenDataSession method (mbnapi.h)

  • Article

Important

Starting in Windows 10, version 1803, the Win32 APIs described in this section are replaced by the Windows Runtime APIs in the Windows.Networking.Connectivity namespace.

Open a data session to the device service on a Mobile Broadband device.

Syntax

HRESULT OpenDataSession(
  [out] ULONG *requestID
);

Parameters

[out] requestID

A unique request ID assigned by the Mobile Broadband service to identify this request.

Return value

The method can return one of the following values.

Return code Description
S_OK
 The method completed successfully.
E_ACCESSDENIED
 This device service command is not allowed for calling process privileges.
HRESULT_FROM_WIN32(ERROR_TOO_MANY_SESS)
 The device service has reached the maximum number of sessions it can support
Other
 An error was encountered when executing this method.

Remarks

OpenDataSession allows an application to open a data session to the mobile broadband device service.

This is an asynchronous operation and OpenDataSession will return immediately. On completion of the operation, the Mobile Broadband service will call the OnOpenDataSessionComplete method of the IMbnDeviceServicesEvents interface.

Requirements

Requirement Value
Target Platform Windows
Header mbnapi.h

See also

IMbnDeviceService