Funzione NPGetConnectionPerformance (npapi.h)

  • Articolo

Restituisce informazioni sulle prestazioni previste di una connessione utilizzata per accedere a una risorsa di rete. La richiesta può essere solo per una risorsa di rete attualmente connessa.

Sintassi

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Parametri

[in] lpRemoteName

Puntatore al nome locale o al nome remoto per una risorsa connessa.

[out] lpNetConnectInfo

Puntatore a una struttura NETCONNECTINFOSTRUCT , compilata dal provider di rete se il provider ha una connessione alla risorsa di rete. Tutti gli altri campi di questa struttura, ad eccezione del campo cbStructure , vengono compilati con zeri prima che MPR passi la richiesta ai provider di rete. Di conseguenza, il provider deve scrivere solo nei campi per i quali sono disponibili informazioni. Inoltre, per i valori di frequenza, il valore 1 indica che le prestazioni sono migliori di quelle che possono essere rappresentate nell'unità.

Le informazioni restituite possono essere una stima. Se la rete non riesce a ottenere informazioni sulla risorsa nella rete, può restituire informazioni sulla scheda di rete e sulle prestazioni associate e quindi impostare il campo dwFlags di conseguenza.

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
 lpRemoteName non è una risorsa di rete connessa.
WN_NO_NETWORK
 La rete non è presente.

Requisiti

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