CfReferenceProtectedHandle-Funktion (cfapi.h)
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 |