IMbnConnection::Disconnect method (mbnapi.h)

Article
10/13/2021

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.

Disconnects a data connection.

Syntax

HRESULT Disconnect(
  [out] ULONG *requestID
);

Parameters

[out] requestID

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

Return value

This method can return one of these values.

Return code	Description
S_OK	The method completed successfully.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	The connection has already been disconnected.

Remarks

Deactivation will also result in the disconnection of the L2 connection.

This is an asynchronous operation that will return immediately. If this method returns successfully, then the Mobile Broadband service will call the OnDisconnectComplete method of IMbnConnectionEvents when the operation is complete.

Windows 8 and later versions of Windows: A Windows Store app may only use Disconnect if the existing MBN connection was initiated by that app using Connect. Disconnect may not be used to disconnect connections that have been made by the user or by the Windows Connection Manager.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps \| UWP apps]
Minimum supported server	None supported
Target Platform	Windows
Header	mbnapi.h