Funzione MultinetGetConnectionPerformanceA (winnetwk.h)

Articolo
11/20/2024

La funzione MultinetGetConnectionPerformance restituisce informazioni sulle prestazioni previste di una connessione usata per accedere a una risorsa di rete.

Sintassi

DWORD MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

Parametri

[in] lpNetResource

Puntatore a una struttura di NETRESOURCE che specifica la risorsa di rete. I membri seguenti hanno significati specifici in questo contesto.

Membro	Significato
lpLocalName	Puntatore a un buffer che specifica un dispositivo locale, ad esempio "F:" o "LPT1", reindirizzato a una risorsa di rete su cui eseguire una query. Se questo membro è NULL o una stringa vuota, la risorsa di rete viene specificata nel membro lpRemoteName. Se questo flag specifica un dispositivo locale, lpRemoteName viene ignorato.
lpRemoteName	Puntatore a una risorsa di rete su cui eseguire query. La risorsa deve attualmente avere una connessione stabilita. Ad esempio, se la risorsa è un file in un file server, l'apertura del file garantisce la connessione.
lpProvider	In genere impostato su NULL, ma può essere un puntatore al proprietario (provider) della risorsa se la rete in cui risiede la risorsa è nota. Se il membro lpProvider non è null, il sistema tenta di restituire informazioni solo sulla rete denominata.

[out] lpNetConnectInfoStruct

Puntatore alla struttura NETCONNECTINFOSTRUCT che riceve i dati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema , ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_NOT_SUPPORTED	La risorsa di rete non fornisce queste informazioni.
ERROR_NOT_CONNECTED	Il membro lpLocalName della struttura NETRESOURCE a cui punta il parametro lpNetResource non specifica un dispositivo reindirizzato o il membro lpRemoteName non specifica il nome di una risorsa attualmente connessa.
ERROR_NO_NET_OR_BAD_PATH	Impossibile completare l'operazione, perché un componente di rete non è avviato o perché il nome della risorsa specificato non viene riconosciuto.
ERROR_BAD_DEVICE	Il dispositivo locale specificato dal membro lpLocalName non è valido.
ERROR_BAD_NET_NAME	Impossibile trovare il nome di rete. Questo errore viene restituito se il membro lpLocalName della struttura NETRESOURCE a cui punta il parametro lpNetResource è stato NULL e il membro lpRemoteName della struttura NETRESOURCE a cui punta il lpNetResource o NULL o non è stato possibile riconoscere da alcuna rete.
ERROR_INVALID_ADDRESS	Tentativo di accesso a un indirizzo non valido. Questo errore viene restituito se i parametri lpNetResource o lpNetConnectInfoStruct erano NULL.
ERROR_INVALID_PARAMETER	È stato passato un parametro non valido. Questo errore viene restituito se il parametro lpNetConnectInfoStruct non punta a una struttura NETCONNECTINFOSTRUCT in cui il membro cbStructure viene riempito con le dimensioni della struttura appropriate.
ERROR_NO_NETWORK	La rete non è disponibile.
ERROR_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare WNetGetLastError.

Osservazioni

La funzione MultinetGetConnectionPerformance restituisce le informazioni in una struttura NETCONNECTINFOSTRUCT .

Le informazioni restituite dalla funzione multinetGetConnectionPerformance sono solo una stima. Il traffico di rete e il routing possono influire sull'accuratezza dei risultati restituiti.

Si noti che la funzione MultinetGetConnectionPerformance può essere usata solo per richiedere informazioni per un dispositivo locale reindirizzato a una risorsa di rete o per una risorsa di rete a cui è attualmente presente una connessione.

Se un percorso UNC viene specificato nel membro lpRemoteName della struttura NETRESOURCE a cui punta il parametro lpNetResource, il membro lpRemoteName deve essere un nome di directory, non un nome file.

Un modo tipico per usare questa funzione consiste nell'aprire un file in un server di rete (che garantisce che sia presente una connessione al file), chiamare questa funzione e usare i risultati per prendere decisioni su come gestire l'I/O dei file. Ad esempio, è possibile decidere se leggere l'intero file in un file temporaneo nel client o accedere direttamente al file nel server.

Nota

L'intestazione winnetwk.h definisce MultinetGetConnectionPerformance come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll

Vedere anche

NETCONNECTINFOSTRUCT

NETRESOURCE

Panoramica rete Windows

Funzioni di rete di Windows

Condividi tramite