NPGetConnection-Funktion (npapi.h)

Ruft Informationen zu einer Verbindung ab.

Syntax

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

Die Parameter

[in] lpLocalName

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

[out] lpRemoteName

Zeigen Sie auf einen Puffer, der den Remotenamen empfängt, der zum Herstellen der Verbindung verwendet wird. Dieser Puffer wird vom Aufrufer zugewiesen.

[in, out] lpnBufferLen

Zeigen Sie auf die Größe des lpRemoteName-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. Andernfalls sollte ein Fehlercode zurückgegeben werden, der eine der folgenden Sein kann:

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

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

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	davclnt.lib