Fonction CfRevertPlaceholder (cfapi.h)
Rétablit un espace réservé dans un fichier normal, supprimant toutes les caractéristiques spéciales telles que la balise d’analyse, l’identité du fichier, etc.
Syntaxe
HRESULT CfRevertPlaceholder(
[in] HANDLE FileHandle,
[in] CF_REVERT_FLAGS RevertFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
Paramètres
[in] FileHandle
Handle de l’espace réservé de fichier ou de répertoire qui est sur le point d’être rétabli dans un fichier ou un répertoire normal. La plateforme synchronise correctement l’opération de restauration avec d’autres requêtes actives. Un attribut ou un handle sans accès est suffisant.
[in] RevertFlags
Indicateurs de rétablissement de l’espace réservé. RevertFlags doit être défini sur CF_REVERT_FLAG_NONE.
[in, out, optional] Overlapped
Lorsqu’il est spécifié et combiné avec un FileHandle asynchrone, le chevauchement permet à la plateforme d’effectuer l’appel CfRevertPlaceholder de manière asynchrone. Pour plus d’informations, consultez les remarques .
Si ce n’est pas spécifié, la plateforme effectue l’appel d’API de manière synchrone, quelle que soit la façon dont le handle a été créé.
Valeur retournée
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
L’appelant doit avoir WRITE_DATA ou WRITE_DAC accès à l’espace réservé à rétablir.
Si l’espace réservé n’est pas encore entièrement hydraté au moment de l’appel, le filtre envoie un rappel FETCH_DATA au fournisseur de synchronisation pour hydrater le fichier. Si le fichier ne peut pas être hydraté, le rétablissement échoue avec status STATUS_CLOUD_FILE_ACCESS_DENIED.
Si l’API retourne HRESULT_FROM_WIN32(ERROR_IO_PENDING) lors de l’utilisation asynchrone du chevauchement , l’appelant peut attendre à l’aide de GetOverlappedResult.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |