Funzione DavGetTheLockOwnerOfTheFile (davclnt.h)

Articolo
08/23/2023

Restituisce il proprietario del blocco file per un file bloccato in un server WebDAV.

Sintassi

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

Parametri

[in] FileName

Puntatore a una stringa Unicode con terminazione Null contenente il nome di un file bloccato nel server WebDAV. Questa stringa deve essere in uno dei formati seguenti:

\\server\path\filename
drive:\filename

dove server è il nome di un server, percorso è il percorso di un file remoto nel server, nome file è un nome file valido e unità è la lettera di unità a cui viene eseguito il mapping di una condivisione remota nel computer locale. Una condivisione è una directory in un server reso disponibile agli utenti in rete.

[out, optional] LockOwnerName

Puntatore a un buffer allocato dal chiamante che riceve il nome del proprietario del blocco del file. Questo parametro è facoltativo e può essere NULL. Se è NULL, il parametro LockOwnerNameLengthInBytes deve puntare a zero nell'input.

[in, out] LockOwnerNameLengthInBytes

Puntatore a una variabile che in input specifica la dimensione massima, in caratteri Unicode, del buffer a cui punta il parametro LockOwnerName . Se la funzione ha esito positivo, nell'output la variabile riceve il numero di caratteri copiati nel buffer. Se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER, nell'output la variabile riceve il numero di caratteri necessari per archiviare il nome del proprietario del blocco, incluso il carattere NULL di terminazione.

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.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Il buffer a cui punta il parametro LockOwnerName non è sufficiente per archiviare il nome del proprietario del blocco.
ERROR_INVALID_PARAMETER	Uno o più valori di parametro non sono validi. Ad esempio, questo codice di errore viene restituito se il parametro FileName è un puntatore Null .

Commenti

Se una chiamata a una funzione come CreateFile per un file in un server WebDAV ha esito negativo con ERROR_LOCK_VIOLATION, è possibile usare la funzione DavGetTheLockOwnerOfTheFile per determinare il proprietario del blocco del file.

Per ottenere la lunghezza del buffer necessaria per il buffer LockOwnerName , chiamare DavGetTheLockOwnerOfTheFile con LockOwnerName impostato su NULL e LockOwnerNameLengthInBytes impostato su zero. Il valore restituito è ERROR_INSUFFICIENT_BUFFER e nell'output il parametro LockOwnerNameLengthInBytes riceve la lunghezza del buffer richiesta.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	davclnt.h
Libreria	Davclnt.lib
DLL	Davclnt.dll

Condividi tramite