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

Siehe auch

CfReleaseProtectedHandle