NPGetConnection3-Funktion (npapi.h)

Artikel
08/25/2023

Ruft Informationen zu einer Netzwerkverbindung ab, auch wenn sie derzeit getrennt ist.

Syntax

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] lpLocalName

Zeiger auf den Namen des lokalen Geräts, an dem der Aufrufer interessiert ist. Der Anbieter kann davon ausgehen, dass dies syntaktisch gültig ist.

[in] dwLevel

Wert, der angibt, ob die Netzwerkverbindung derzeit verbunden oder getrennt ist.

Wert	Bedeutung
WNGETCON_CONNECTED	Die Netzwerkverbindung ist verbunden.
WNGETCON_DISCONNECTED	Die Netzwerkverbindung wird getrennt.

[out] lpBuffer

Void-Zeiger, der einen Puffer empfängt, der die angeforderten Informationen enthält.

[in, out] lpBufferSize

Zeiger auf die Größe des lpBuffer-Puffers in Zeichen. Wenn der Aufruf fehlschlägt, weil der Puffer nicht groß genug ist, wird lpBufferSize auf die erforderliche Puffergröße festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben.

Wenn die Funktion fehlschlägt, sollte sie einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
WN_NOT_CONNECTED	Das von lpLocalName angegebene Gerät wird von diesem Anbieter nicht umgeleitet.
WN_MORE_DATA	Der Puffer war zu klein, um alle Daten zu empfangen.
WN_NO_NETWORK	Das Netzwerk ist nicht vorhanden.

Hinweise

Eine Netzwerkverbindung kann in drei Zuständen vorhanden sein: verbunden, getrennt und nicht verfügbar. Die NPGetConnection3-Funktion kann keine Informationen zu Netzwerkverbindungen abrufen, die derzeit nicht verfügbar sind. Es kann jedoch Informationen zu Netzwerkverbindungen abrufen, die derzeit getrennt sind, da Windows die Verbindungsinformationen speichert.

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	npapi.h

Freigeben über