Funzione NPGetConnection (npapi.h)

  • Articolo

Recupera informazioni su una connessione.

Sintassi

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

Parametri

[in] lpLocalName

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

[out] lpRemoteName

Puntatore a un buffer che riceverà il nome remoto usato per effettuare la connessione. Questo buffer viene allocato dal chiamante.

[in, out] lpnBufferLen

Puntatore alle dimensioni, in caratteri, del buffer lpRemoteName . Se la chiamata ha esito negativo perché il buffer non è abbastanza grande, lpBufferSize è impostato sulla dimensione del buffer necessaria.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore, che può essere uno dei 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

La funzione NPGetConnection può restituire informazioni solo su una connessione di rete attualmente connessa. Per recuperare informazioni su una connessione di rete attualmente disconnessa, usare NPGetConnection3.

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