Funzione MultinetGetConnectionPerformanceA (winnetwk.h)
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 NETRESOURCE che specifica la risorsa di rete. I membri seguenti hanno significati specifici in questo contesto.
[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 |
---|---|
|
La risorsa di rete non fornisce queste informazioni. |
|
Il membro lpLocalName della struttura NETRESOURCE a cui fa riferimento il parametro lpNetResource non specifica un dispositivo reindirizzato oppure il membro lpRemoteName non specifica il nome di una risorsa attualmente connessa. |
|
Impossibile completare l'operazione, perché un componente di rete non viene avviato o perché il nome della risorsa specificato non viene riconosciuto. |
|
Il dispositivo locale specificato dal membro lpLocalName non è valido. |
|
Impossibile trovare il nome della rete. Questo errore viene restituito se il membro lpLocalName della struttura NETRESOURCE puntato al parametro lpNetResource era NULL e il membro lpRemoteName della struttura NETRESOURCE puntato alla struttura lpNetResource era anche o NULL o non è stato riconosciuto da alcuna rete. |
|
Tentativo di accesso a un indirizzo non valido. Questo errore viene restituito se i parametri lpNetResource o lpNetConnectInfoStruct erano NULL. |
|
È 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. |
|
La rete non è disponibile. |
|
Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare WNetGetLastError. |
Commenti
La funzione MultinetGetConnectionPerformance restituisce le informazioni in una struttura NETCONNECTINFOSTRUCT .
Le informazioni restituite dalla funzione MultinetGetConnectionPerformance sono una stima solo. 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 viene specificato un percorso UNC 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 del 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | winnetwk.h |
Libreria | Mpr.lib |
DLL | Mpr.dll |