CfGetWin32HandleFromProtectedHandle-Funktion (cfapi.h)
Konvertiert ein geschütztes Handle in ein Win32-Handle, sodass es mit allen handle-basierten Win32-APIs verwendet werden kann.
Syntax
HANDLE CfGetWin32HandleFromProtectedHandle(
[in] HANDLE ProtectedHandle
);
Parameter
[in] ProtectedHandle
Das zu konvertierende geschützte Handle.
Rückgabewert
Das entsprechende Win32-Handle.
Hinweise
Der Aufrufer muss vor diesem Aufruf mithilfe von CfReferenceProtectedHandle auf das geschützte Handle verwiesen haben, um sicherzustellen, dass die Verwendung des Win32-Handle nachverfolgt wird, und der Win32-API-Aufruf, der das Win32-Handle nutzt, mit der Bestätigung der Oplock-Unterbrechungsbenachrichtigung synchronisiert wird.
Der Aufrufer muss den Verweis auf das geschützte Handle freigeben, nachdem er mit dem Win32-Handle mithilfe von CfReleaseProtectedHandle ausgeführt wurde.
In keinem Fall sollte der Aufrufer das win32-Handle schließen, das mithilfe von CfCloseHandle zurückgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |