Funzione WNetGetLastErrorA (winnetwk.h)

Articolo
11/20/2024

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 ancora con terminazione 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 ancora con terminazione 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.

Osservazioni

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, mantenute per ogni thread. A differenza di GetLastError, la funzione WNetGetLastError può restituire una stringa per segnalare errori non 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 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

Panoramica rete Windows

Funzioni di rete di Windows

Condividi tramite