Funzione NPGetConnection3 (npapi.h)

  • Articolo

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