DavGetTheLockOwnerOfTheFile-Funktion (davclnt.h)

Artikel
08/23/2023

Gibt den Besitzer der Dateisperre für eine Datei zurück, die auf einem WebDAV-Server gesperrt ist.

Syntax

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

Parameter

[in] FileName

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen einer gesperrten Datei auf dem WebDAV-Server enthält. Diese Zeichenfolge muss in einem der folgenden Formate vorliegen:

\\server\path\filename
Laufwerk:\Dateiname

Dabei ist server der Name eines Servers, Pfad ist der Pfad zu einer Remotedatei auf dem Server, Dateiname ist ein gültiger Dateiname und Laufwerk der Laufwerkbuchstaben, dem eine Remotefreigabe auf dem lokalen Computer zugeordnet ist. (Eine Freigabe ist ein Verzeichnis auf einem Server, das Benutzern über das Netzwerk zur Verfügung gestellt wird.)

[out, optional] LockOwnerName

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der den Namen des Besitzers der Dateisperre empfängt. Dieser Parameter ist optional und kann NULL sein. Wenn er NULL ist, muss der LockOwnerNameLengthInBytes-Parameter bei der Eingabe auf 0 zeigen.

[in, out] LockOwnerNameLengthInBytes

Ein Zeiger auf eine Variable, die bei der Eingabe die maximale Größe des Puffers in Unicode-Zeichen angibt, auf die der LockOwnerName-Parameter verweist. Wenn die Funktion erfolgreich ist, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die in den Puffer kopiert wurden. Wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die zum Speichern des Besitzernamens der Sperre erforderlich sind, einschließlich des beendenden NULL-Zeichens.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Der Puffer, auf den der LockOwnerName-Parameter verweist, war nicht groß genug, um den Namen des Schlossbesitzers zu speichern.
ERROR_INVALID_PARAMETER	Mindestens ein Parameterwert war ungültig. Dieser Fehlercode wird beispielsweise zurückgegeben, wenn der FileName-Parameter ein NULL-Zeiger ist.

Hinweise

Wenn ein Aufruf einer Funktion wie CreateFile für eine Datei auf einem WebDAV-Server mit ERROR_LOCK_VIOLATION fehlschlägt, können Sie die DavGetTheLockOwnerOfTheFile-Funktion verwenden, um den Besitzer der Dateisperre zu bestimmen.

Um die erforderliche Pufferlänge für den LockOwnerName-Puffer abzurufen, rufen Sie DavGetTheLockOwnerOfTheFile auf, wobei LockOwnerName auf NULL und LockOwnerNameLengthInBytes auf Null festgelegt ist. Der Rückgabewert ist ERROR_INSUFFICIENT_BUFFER, und bei der Ausgabe empfängt der LockOwnerNameLengthInBytes-Parameter die erforderliche Pufferlänge.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	davclnt.h
Bibliothek	Davclnt.lib
DLL	Davclnt.dll

Freigeben über