NPGetConnection-Funktion (npapi.h)

Artikel
02/29/2024

Ruft Informationen zu einer Verbindung ab.

Syntax

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Parameter

[in] lpLocalName

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

[out] lpRemoteName

Zeiger auf einen Puffer, der den Remotenamen empfängt, der zum Herstellen der Verbindung verwendet wird. Dieser Puffer wird vom Aufrufer zugeordnet.

[in, out] lpnBufferLen

Zeiger auf die Größe des Puffers lpRemoteName 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. Andernfalls sollte ein Fehlercode zurückgegeben werden, der wie folgt aussehen kann:

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

Die NPGetConnection-Funktion kann nur Informationen zu einer Netzwerkverbindung zurückgeben, die derzeit verbunden ist. Verwenden Sie NPGetConnection3, um Informationen zu einer derzeit getrennten Netzwerkverbindung abzurufen.

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