Compartir a través de

Función DavGetExtendedError (davclnt.h)

  • Artículo

Recupera la información de código de error extendida que devolvió el servidor WebDAV para la operación de E/S con errores anterior.

Sintaxis

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

Parámetros

[in] hFile

Identificador de un archivo abierto para el que se ha producido un error en la operación de E/S anterior. Si la operación anterior es una operación de creación con errores, en cuyo caso no hay ningún identificador de archivo abierto, especifique INVALID_HANDLE_VALUE para este parámetro.

[out] ExtError

Puntero a una variable que recibe el código de error extendido.

[out] ExtErrorString

Puntero a un búfer que recibe la información de error extendida como una cadena Unicode terminada en null.

[in, out] cChSize

Puntero a una variable que en la entrada especifica el tamaño, en caracteres Unicode, del búfer al que apunta el parámetro ExtErrorString . Este valor debe tener al menos 1024 caracteres.

Si la función se ejecuta correctamente, en la salida, la variable recibe el número de caracteres que se copian realmente en el búfer. Si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER, la variable recibe 1024, pero no se copian caracteres en el búfer ExtErrorString .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema, como uno de los siguientes valores.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios valores de parámetro no eran válidos.
ERROR_INSUFFICIENT_BUFFER
 El valor al que apunta el parámetro cChSize era menor que 1024.

Comentarios

Si llama a esta función para un identificador de archivo cuya operación de E/S anterior se realizó correctamente, devuelve ERROR_INVALID_PARAMETER.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado davclnt.h
Library Netapi32.lib
Archivo DLL Netapi32.dll

Consulte también

CreateFile

OpenFile

WriteFile