NPGetConnection3-Funktion (npapi.h)

  • Artikel

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