Funzione NPGetConnection3 (npapi.h)

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.

Value	Meaning
WNGETCON_CONNECTED	La connessione di rete è connessa.
WNGETCON_DISCONNECTED	La connessione di rete è disconnessa.

[out] lpBuffer

Puntatore void che riceve un buffer contenente le informazioni richieste.

[in, out] lpBufferSize

Puntatore alle dimensioni, in caratteri, del buffer lpBuffer . Se la chiamata ha esito negativo 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 non riesce, deve restituire uno dei valori seguenti.

Codice restituito	Description
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.

Osservazioni:

Una connessione di rete può esistere in tre stati: connessa, disconnessa 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	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Header	npapi.h
Library	nanosrv.lib