IMbnInterface::GetReadyState メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

準備完了状態を取得します。

構文

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

パラメーター

[out, retval] readyState

MBN_READY_STATE構造体へのポインター。 このメソッドが S_OK 以外の値を返す場合、このパラメーターは NULL です。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。 readyState には有効な値が含まれています。
E_PENDING	この情報は使用できません。 モバイル ブロードバンド サービスは現在、準備完了状態をプローブしています。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnReadyStateChange メソッドに登録することで、準備完了状態が使用可能になったときに通知を受け取ることができます。

解説

ready 状態は、インターフェイスが正常に初期化され、接続操作を実行する準備ができているかどうかを指定します。 SIM ベースのデバイスの場合、デバイスによって SIM が正常に初期化されると、デバイスの準備が整います。 デバイスは、準備完了状態が MBN_READY_STATE_INITIALIZEDされている場合にのみ接続に使用できます。 その他のデバイスの状態の詳細については、「 MBN_READY_STATE」を参照してください。

インターフェイスの準備状態は、ユーザー操作の結果として変更される可能性があります。 たとえば、ユーザーが SIM をデバイスに挿入すると、準備完了状態が MBN_READY_STATE_SIM_NOT_INSERTED から別の準備完了状態に変わります。 また、アプリケーションによって実行されるその他の操作により、準備完了状態が変更される場合もあります。 たとえば、PIN が入力されると、準備完了状態が MBN_READY_STATE_DEVICE_LOCKED から別の準備完了状態に変わる可能性があります。 アプリケーションは、インターフェイスの準備完了状態に変更がある場合は常に、イベント通知に登録できます。 IMbnInterfaceEvents の OnReadyStateChange メンバーが呼び出され、準備完了状態の変更についてアプリケーションに通知されます。

デバイスの SMS サブシステムは、 MBN_READY_STATE_INITIALIZEDを報告するときに準備ができていない可能性があります。 呼び出し元アプリケーションは、SMS サブシステムの準備ができていることを示す、IMbnSmsEvents の OnSmsConfigurationChange メンバーの呼び出しを待機する必要があります。

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mbnapi.h

関連項目

IMbnInterface