Funzione WNetGetLastErrorA (winnetwk.h)
La funzione WNetGetLastError recupera il codice di errore esteso più recente impostato da una funzione WNet. Il provider di rete ha segnalato questo codice di errore; in genere non sarà uno degli errori inclusi nel file di intestazione SDK WinError.h.
Sintassi
DWORD WNetGetLastErrorA(
[out] LPDWORD lpError,
[out] LPSTR lpErrorBuf,
[in] DWORD nErrorBufSize,
[out] LPSTR lpNameBuf,
[in] DWORD nNameBufSize
);
Parametri
[out] lpError
Puntatore a una variabile che riceve il codice di errore segnalato dal provider di rete. Il codice di errore è specifico del provider di rete.
[out] lpErrorBuf
Puntatore al buffer che riceve la stringa con terminazione Null che descrive l'errore.
[in] nErrorBufSize
Dimensioni del buffer a cui punta il parametro lpErrorBuf , in caratteri. Se il buffer è troppo piccolo per la stringa di errore, la stringa viene troncata ma terminata ancora null. È consigliabile un buffer di almeno 256 caratteri.
[out] lpNameBuf
Puntatore al buffer che riceve la stringa con terminazione Null che identifica il provider di rete che ha generato l'errore.
[in] nNameBufSize
Dimensioni del buffer a cui punta il parametro lpNameBuf , in caratteri. Se il buffer è troppo piccolo per la stringa di errore, la stringa viene troncata ma terminata ancora null.
Valore restituito
Se la funzione ha esito positivo e ottiene l'ultimo errore segnalato dal provider di rete, il valore restituito viene NO_ERROR.
Se il chiamante fornisce un buffer non valido, il valore restituito viene ERROR_INVALID_ADDRESS.
Commenti
La funzione WNetGetLastError recupera gli errori specifici di un provider di rete. È possibile chiamare WNetGetLastError quando una funzione WNet restituisce ERROR_EXTENDED_ERROR.
Analogamente alla funzione GetLastError , WNetGetLastError restituisce informazioni di errore estese, che vengono mantenute per ogni thread. A differenza di GetLastError, la funzione WNetGetLastError può restituire una stringa per segnalare errori che non sono descritti da alcun codice di errore esistente in WinError.h.
Per altre informazioni sull'uso di un gestore errori definito dall'applicazione che chiama la funzione WNetGetLastError , vedere Recupero di errori di rete.
Nota
L'intestazione winnetwk.h definisce WNetGetLastError 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |