IsDestinationReachableA-Funktion (sensapi.h)

Die IsDestinationReachable-Funktion bestimmt, ob ein angegebenes Ziel erreicht werden kann, und stellt QOC-Informationen (Quality of Connection) für ein Ziel bereit.

Windows Vista und höher, Windows Server 2008 und höher: Diese Funktion wird nicht unterstützt und gibt immer ERROR_CALL_NOT_IMPLEMENTED zurück.

Syntax

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

Parameter

[in] lpszDestination

Ein Zeiger auf eine NULL-Zeichenfolge, die ein Ziel angibt. Das Ziel kann eine IP-Adresse, ein UNC-Name oder eine URL sein.

[in, out] lpQOCInfo

Ein Zeiger auf die QOCINFO-Struktur , die die QOC-Informationen (Quality of Connection) empfängt. Sie können einen NULL-Zeiger angeben, wenn Sie die QOC-Informationen nicht erhalten möchten.

Rückgabewert

Rückgabecode	Beschreibung
TRUE	Ein Ziel kann erreicht werden.
FALSE	Ein Ziel kann nicht erreicht werden. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
ERROR_CALL_NOT_IMPLEMENTED	Diese Funktion ist unter Windows Vista nicht verfügbar.

Hinweise

Clientanwendungen verwenden diese Funktion, um die QOC-Informationen zu ermitteln, bevor sie mit Netzwerkvorgängen fortfahren. Bei eigenständigen Computern, die über ein Netzwerk Karte oder RAS(RAS) direkt mit einem Netzwerk verbunden sind, generiert diese Funktion minimalen Netzwerkdatenverkehr mit RPC-Aufrufen des nächstgelegenen Routers. Bei Computern, die Teil eines Netzwerks sind, auf denen ein Ziel mithilfe von RAS oder einem Netzwerkgateway erreicht werden kann, pingt diese Funktion ein Ziel an, um genaue QOC-Informationen zu generieren.

Diese Funktion ist nur für TCP/IP-Verbindungen verfügbar. Ein Aufrufer stellt den Puffer für die QOCINFO-Struktur bereit und muss den Arbeitsspeicher freigeben, wenn er nicht benötigt wird.

Ab Anwendungen, die für Windows Vista und Windows Server 2008 entwickelt wurden, sollten Entwickler den Netzwerklisten-Manager anstelle dieser Funktion in Erwägung ziehen.

Hinweis

Der sensapi.h-Header definiert IsDestinationReachable als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sensapi.h
Bibliothek	Sensapi.lib
DLL	Sensapi.dll

Weitere Informationen

Informationen zum Systemereignisbenachrichtigungsdienst

IsNetworkAlive

QOCINFO