Funzione WNetSetLastErrorA (npapi.h)

  • Articolo

Imposta le informazioni estese sull'errore. I provider di rete devono chiamare questa funzione anziché SetLastError.

Se necessario, il router MPR ( Multiple Provider Router ) chiama SetLastError per impostare l'errore di Windows restituito da un provider di rete.

Sintassi

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR lpProviders
);

Parametri

[in] err

Errore che si è verificato. Si tratta di un codice di errore specifico della rete.

[in] lpError

Stringa che descrive l'errore specifico della rete.

[in] lpProviders

Stringa che denomina il provider di rete che ha generato l'errore.

Valore restituito

nessuno

Osservazioni

Questa funzione viene implementata dal sistema operativo Windows e può essere chiamata dai provider di rete.

Un provider deve usare questa funzione per segnalare errori contenenti informazioni specifiche del provider. Le informazioni sull'errore vengono salvate finché non vengono sovrascritte da un'altra chiamata a WNetSetLastError nello stesso thread.

Il modo consigliato per gestire gli errori generali di una funzione del provider consiste nell'usare l'istruzione seguente.

return(providerError);

In questa istruzione providerError è un codice di errore di Windows, ad esempio uno dei codici restituiti elencati per l'API del provider in questo documento.

Per gli errori specifici del provider, un provider deve eseguire le operazioni seguenti.

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName) ;
return(ERROR_EXTENDED_ERROR) ;

In questo caso, providerError è il codice di errore specifico del provider.

I provider non devono chiamare SetLastError prima di restituire da una funzione del provider. Il mpr chiama SetLastError per impostare l'errore di Windows restituito da un provider quando necessario per soddisfare le applicazioni.

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
Libreria Mpr.lib
DLL Mpr.dll