Funzione DavGetExtendedError (davclnt.h)

Recupera le informazioni sul codice di errore estese restituite dal server WebDAV per l'operazione di I/O non riuscita precedente.

Sintassi

DWORD DavGetExtendedError(
  [in]      HANDLE hFile,
  [out]     DWORD  *ExtError,
  [out]     LPWSTR ExtErrorString,
  [in, out] DWORD  *cChSize
);

Parametri

[in] hFile

Handle per un file aperto per il quale l'operazione di I/O precedente non è riuscita. Se l'operazione precedente è un'operazione di creazione non riuscita, nel qual caso non è presente alcun handle di file aperto, specificare INVALID_HANDLE_VALUE per questo parametro.

[out] ExtError

Puntatore a una variabile che riceve il codice di errore esteso.

[out] ExtErrorString

Puntatore a un buffer che riceve le informazioni di errore estese come stringa Unicode con terminazione Null.

[in, out] cChSize

Puntatore a una variabile a cui l'input specifica le dimensioni, in caratteri Unicode, del buffer a cui punta il parametro ExtErrorString . Questo valore deve essere di almeno 1024 caratteri.

Se la funzione ha esito positivo, nell'output la variabile riceve il numero di caratteri effettivamente copiati nel buffer. Se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER, la variabile riceve 1024, ma non vengono copiati caratteri nel buffer ExtErrorString .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.

Commenti

Se si chiama questa funzione per un handle di file la cui operazione di I/O precedente ha avuto esito positivo, restituisce ERROR_INVALID_PARAMETER.

Requisiti

Vedi anche

CreateFile

OpenFile

WriteFile