Share via

CfReferenceProtectedHandle-Funktion (cfapi.h)

  • Artikel

Ermöglicht dem Aufrufer, auf ein geschütztes Handle auf ein Win32-Handle zu verweisen, das mit Nicht-CfApi Win32-APIs verwendet werden kann.

Syntax

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parameter

[in] ProtectedHandle

Das geschützte Handle einer Platzhalterdatei.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird zurückgegeben TRUE. Andernfalls wird FALSEzurückgegeben.

Hinweise

Jeder CfReferenceProtectedHandle-Aufruf muss mit einem CfReleaseProtectedHandle-Aufruf abgeglichen werden. Es wird nicht empfohlen, für einen längeren Zeitraum auf ein geschütztes Handle zu verweisen, da dadurch verhindert wird, dass die Oplock-Unterbrechungsbenachrichtigung bestätigt wird.

Der Aufrufer sollte stattdessen aufgaben mit langer Ausführungsdauer in kleinere Unteraufgaben aufteilen und das geschützte Handle für jede Unteraufgabe verweisen bzw. freigeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile cfapi.h
Bibliothek CldApi.lib
DLL CldApi.dll

Siehe auch

CfReleaseProtectedHandle