ネットワークの無線に関連付けられている信号品質値を取得します。
構文
HRESULT GetSignalQuality(
[out] ULONG *puStrengthValue,
[out] ULONG *puStrengthMax
);
パラメーター
[out] puStrengthValue
現在の信号強度。 このパラメーターは、0 から puStrengthMax までの ULONG 値を受け取ります。
[out] puStrengthMax
最大信号強度値。 このパラメーターは、0 ~ 100 の ULONG 値を受け取ります。 既定では、 puStrengthMax は 100 に設定されています。
戻り値
可能な戻り値は次のとおりですが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
メソッドが失敗しました。 |
|
いずれかのパラメーターが無効です。 |
|
メソッドは、この操作を実行するために必要なメモリを割り当てませんでした。 |
|
パラメーターとして渡されたポインターが無効です。 |
注釈
このコンテキストでは、シグナル強度は線形スケールで測定されます。 puStrengthMax が既定値の 100 に設定されている場合、puStrengthValue は、現在送信に使用されている最大信号強度の割合を表します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | adhoc.h |