StgGetIFillLockBytesOnFile, fonction (objbase.h)

Article
03/04/2024

[La fonction StgGetIFillLockBytesOnFile est obsolète. Les informations suivantes sont fournies pour prendre en charge les versions de Windows antérieures à Windows 2000.]

La fonction StgGetIFillLockBytesOnFile ouvre un objet wrapper sur un fichier temporaire.

Syntaxe

HRESULT StgGetIFillLockBytesOnFile(
  [in]  OLECHAR const  *pwcsName,
  [out] IFillLockBytes **ppflb
);

Paramètres

[in] pwcsName

Pointeur vers le nom de chaîne Unicode terminé par null du fichier pour lequel un objet wrapper est créé.

[out] ppflb

Pointeur vers la variable pointeur IFillLockBytes* qui reçoit le pointeur d’interface vers le nouvel objet wrapper de tableau d’octets.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG et E_FAIL, en plus des éléments suivants :

La fonction StgGetIFillLockBytesOnFile peut également retourner toutes les erreurs du système de fichiers.

Remarques

Le moniker qui gère le téléchargement du fichier spécifié dans pwcsName appelle cette fonction au cours de la création du stockage asynchrone nécessaire pour gérer le téléchargement asynchrone des données. Le moniker crée d’abord un fichier temporaire, puis appelle cette fonction pour créer l’objet wrapper sur ce fichier. Enfin, le moniker appelle StgOpenAsyncDocfileOnIFillLockBytes pour ouvrir le stockage racine du fichier composé à télécharger dans le fichier temporaire.