Fonction CfReferenceProtectedHandle (cfapi.h)
Permet à l’appelant de référencer un handle protégé à un handle Win32 qui peut être utilisé avec des API Win32 non CfApi.
Syntaxe
BOOLEAN CfReferenceProtectedHandle(
[in] HANDLE ProtectedHandle
);
Paramètres
[in] ProtectedHandle
Handle protégé d’un fichier d’espace réservé.
Valeur retournée
Si cette fonction réussit, elle retourne TRUE. Sinon, FALSEest retourné.
Notes
Chaque appel CfReferenceProtectedHandle doit être mis en correspondance avec un appel CfReleaseProtectedHandle . Il n’est pas recommandé de référencer un handle protégé pendant une longue période, car cela empêchera la notification d’arrêt d’opération d’être reconnue.
L’appelant doit à la place diviser les tâches longues en sous-tâches plus petites et référencer/libérer le handle protégé pour chaque sous-tâche.
Configuration requise
| Client minimal pris en charge | Windows 10, version 1709 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | cfapi.h |
| Bibliothèque | CldApi.lib |
| DLL | CldApi.dll |