Compartir a través de

Función DavGetTheLockOwnerOfTheFile (davclnt.h)

  • Artículo

Devuelve el propietario del bloqueo de archivo para un archivo bloqueado en un servidor WebDAV.

Sintaxis

DWORD DavGetTheLockOwnerOfTheFile(
  [in]            LPCWSTR FileName,
  [out, optional] PWSTR   LockOwnerName,
  [in, out]       PULONG  LockOwnerNameLengthInBytes
);

Parámetros

[in] FileName

Puntero a una cadena Unicode terminada en null que contiene el nombre de un archivo bloqueado en el servidor WebDAV. Esta cadena debe tener uno de los siguientes formatos:

  • \\server\path\filename
  • drive:\filename
donde el servidor es el nombre de un servidor, la ruta de acceso es la ruta de acceso a un archivo remoto en el servidor, el nombre de archivo es un nombre de archivo válido y la unidad es la letra de unidad a la que se asigna un recurso compartido remoto en el equipo local. (Un recurso compartido es un directorio en un servidor que está disponible para los usuarios a través de la red).

[out, optional] LockOwnerName

Puntero a un búfer asignado por el autor de la llamada que recibe el nombre del propietario del bloqueo de archivo. Este parámetro es opcional y puede ser NULL. Si es NULL, el parámetro LockOwnerNameLengthInBytes debe apuntar a cero en la entrada.

[in, out] LockOwnerNameLengthInBytes

Puntero a una variable que en la entrada especifica el tamaño máximo, en caracteres Unicode, del búfer al que apunta el parámetro LockOwnerName . Si la función se ejecuta correctamente, en la salida, la variable recibe el número de caracteres que se copiaron en el búfer. Si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER, en la salida, la variable recibe el número de caracteres necesarios para almacenar el nombre del propietario del bloqueo, incluido el carácter NULL de terminación.

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_INSUFFICIENT_BUFFER
 El búfer al que apunta el parámetro LockOwnerName no era lo suficientemente grande como para almacenar el nombre del propietario del bloqueo.
ERROR_INVALID_PARAMETER
 Uno o varios valores de parámetro no eran válidos. Por ejemplo, este código de error se devuelve si el parámetro FileName es un puntero nulo .

Comentarios

Si se produce un error en una llamada a una función como CreateFile para un archivo en un servidor WebDAV con ERROR_LOCK_VIOLATION, puede usar la función DavGetTheLockOwnerOfTheFile para determinar el propietario del bloqueo de archivo.

Para obtener la longitud de búfer necesaria para el búfer LockOwnerName , llame a DavGetTheLockOwnerOfTheFile con LockOwnerName establecido en NULL y LockOwnerNameLengthInBytes establecido en cero. El valor devuelto es ERROR_INSUFFICIENT_BUFFER y, en la salida, el parámetro LockOwnerNameLengthInBytes recibe la longitud del búfer necesaria.

Requisitos

   
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 Davclnt.lib
Archivo DLL Davclnt.dll