NPGetConnection3-Funktion (npapi.h)

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

Syntax

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

Die Parameter

[in] lpLocalName

Zeigen Sie auf den Namen des lokalen Geräts, an dem der Anrufer 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 ist getrennt.

[out] lpBuffer

Ungültiger Zeiger, der einen Puffer empfängt, der die angeforderten Informationen enthält.

[in, out] lpBufferSize

Zeigen Sie auf die Größe des lpBuffer-Puffers in Zeichen. Wenn der Aufruf fehlschlägt, da 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	Description
WN_NOT_CONNECTED	Das durch 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.

Bemerkungen

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 zurzeit nicht verfügbar sind. Sie kann jedoch Informationen zu Netzwerkverbindungen abrufen, die derzeit getrennt sind, da Windows die Verbindungsinformationen speichert.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	npapi.h
Library	nanosrv.lib