Compartilhar via

Função DavGetExtendedError (davclnt.h)

  • Artigo

Recupera as informações de código de erro estendidas que o servidor WebDAV retornou para a operação de E/S com falha anterior.

Sintaxe

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

Parâmetros

[in] hFile

Um identificador para um arquivo aberto para o qual a operação de E/S anterior falhou. Se a operação anterior for uma operação de criação com falha, nesse caso, não há identificador de arquivo aberto, especifique INVALID_HANDLE_VALUE para esse parâmetro.

[out] ExtError

Ponteiro para uma variável que recebe o código de erro estendido.

[out] ExtErrorString

Ponteiro para um buffer que recebe as informações de erro estendidas como uma cadeia de caracteres Unicode terminada em nulo.

[in, out] cChSize

Um ponteiro para uma variável que na entrada especifica o tamanho, em caracteres Unicode, do buffer para o qual o parâmetro ExtErrorString aponta. Esse valor deve ter pelo menos 1.024 caracteres.

Se a função for bem-sucedida, na saída a variável receberá o número de caracteres que são realmente copiados para o buffer. Se a função falhar com ERROR_INSUFFICIENT_BUFFER, a variável receberá 1024, mas nenhum caractere será copiado para o buffer ExtErrorString .

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais valores de parâmetro não eram válidos.
ERROR_INSUFFICIENT_BUFFER
 O valor para o qual o parâmetro cChSize aponta era menor que 1024.

Comentários

Se você chamar essa função para um identificador de arquivo cuja operação de E/S anterior foi bem-sucedida, ela retornará ERROR_INVALID_PARAMETER.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho davclnt.h
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

CreateFile

OpenFile

WriteFile