Fonction CfGetPlaceholderRangeInfo (cfapi.h)

Obtient des informations de plage sur un fichier ou un dossier d’espace réservé.

Syntaxe

HRESULT CfGetPlaceholderRangeInfo(
  [in]            HANDLE                          FileHandle,
  [in]            CF_PLACEHOLDER_RANGE_INFO_CLASS InfoClass,
  [in]            LARGE_INTEGER                   StartingOffset,
  [in]            LARGE_INTEGER                   Length,
  [out]           PVOID                           InfoBuffer,
  [in]            DWORD                           InfoBufferLength,
  [out, optional] PDWORD                          ReturnedLength
);

Paramètres

[in] FileHandle

Handle du fichier d’espace réservé à interroger.

[in] InfoClass

Types de la plage de données d’espace réservé.

[in] StartingOffset

Décalage du point de départ de la plage de données.

[in] Length

Longueur de la plage de données. Un fournisseur peut spécifier CF_EOFpour Length pour indiquer que la plage pour laquelle les informations sont demandées est de StartingOffset à la fin du fichier.

[out] InfoBuffer

Pointeur vers une mémoire tampon qui recevra les données. La mémoire tampon est un tableau de structures CF_FILE_RANGE , qui sont des paires décalage/longueur, décrivant les plages demandées.

[in] InfoBufferLength

Longueur d’InfoBuffer en octets.

[out, optional] ReturnedLength

Longueur de la plage retournée de données d’espace réservé dans InfoBuffer.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT . Certains codes d’erreur courants sont répertoriés dans le tableau suivant :

Notes

Contrairement à la plupart des API d’espace réservé qui prennent un handle de fichier, celui-ci ne modifie pas le fichier de quelque manière que ce soit. Par conséquent, le handle de fichier nécessite uniquement READ_ATTRIBUTES accès.

Configuration requise

Voir aussi

CfGetPlaceholderRangeInfoForHydration