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.

[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.

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