IDot11AdHocNetwork::GetSignalQuality-Methode (adhoc.h)

Artikel
08/22/2023

Ruft die Signalqualitätswerte ab, die dem Funkgerät des Netzwerks zugeordnet sind.

Syntax

HRESULT GetSignalQuality(
  [out] ULONG *puStrengthValue,
  [out] ULONG *puStrengthMax
);

Parameter

[out] puStrengthValue

Die aktuelle Signalstärke. Dieser Parameter akzeptiert einen ULONG-Wert zwischen 0 und puStrengthMax.

[out] puStrengthMax

Der maximale Signalstärkewert. Dieser Parameter akzeptiert einen ULONG-Wert zwischen 0 und 100. Standardmäßig ist puStrengthMax auf 100 festgelegt.

Rückgabewert

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_FAIL	Fehler bei der Methode.
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Die -Methode konnte den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Ein als Parameter übergebener Zeiger ist ungültig.

Hinweise

Die Signalstärke wird in diesem Zusammenhang auf einer linearen Skala gemessen. Wenn puStrengthMax auf den Standardwert 100 festgelegt ist, stellt puStrengthValue den Prozentsatz der maximalen Signalstärke dar, die derzeit für die Übertragung verwendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	adhoc.h

Weitere Informationen

IDot11AdHocNetwork

Freigeben über