Funzione NPGetConnection (npapi.h)

Articolo
03/05/2024

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

Condividi tramite