Funzione NPGetConnection3 (npapi.h)

Articolo
03/05/2024

Recupera informazioni su una connessione di rete, anche se è attualmente disconnessa.

Sintassi

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

Parametri

[in] lpLocalName

Puntatore al nome del dispositivo locale a cui è interessato il chiamante. Il provider può presupporre che sia sintatticamente valido.

[in] dwLevel

Valore che specifica se la connessione di rete è attualmente connessa o disconnessa.

Valore	Significato
WNGETCON_CONNECTED	La connessione di rete è connessa.
WNGETCON_DISCONNECTED	La connessione di rete è disconnessa.

[out] lpBuffer

Puntatore void che riceve un buffer che contiene le informazioni richieste.

[in, out] lpBufferSize

Puntatore alla dimensione, in caratteri, del buffer lpBuffer . Se la chiamata non riesce perché il buffer non è sufficientemente grande, lpBufferSize viene impostato sulle dimensioni del buffer necessarie.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS.

Se la funzione ha esito negativo, deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
WN_NOT_CONNECTED	Il dispositivo specificato da lpLocalName non viene reindirizzato da questo provider.
WN_MORE_DATA	Il buffer era troppo piccolo per ricevere tutti i dati.
WN_NO_NETWORK	La rete non è presente.

Commenti

Una connessione di rete può esistere in tre stati: connesso, disconnesso e non disponibile. La funzione NPGetConnection3 non può recuperare informazioni sulle connessioni di rete attualmente non disponibili. Tuttavia, può recuperare informazioni sulle connessioni di rete attualmente disconnesse perché Windows archivia le informazioni di connessione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	npapi.h

Condividi tramite