Funzione WNetGetLastErrorA (winnetwk.h)

  • Articolo

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

Vedi anche

Panoramica di Windows Networking (WNet)

Funzioni di rete di Windows