Fonction StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Article
03/09/2024

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

StgOpenAsyncDocfileOnIFillLockBytes ouvre un objet de stockage asynchrone racine existant sur un objet wrapper de tableau d’octets fourni par l’appelant.

Syntaxe

HRESULT StgOpenAsyncDocfileOnIFillLockBytes(
  [in]  IFillLockBytes *pflb,
  [in]  DWORD          grfMode,
  [in]  DWORD          asyncFlags,
  [out] IStorage       **ppstgOpen
);

Paramètres

[in] pflb

Pointeur IFillLockBytes vers l’objet wrapper de tableau d’octets qui contient l’objet de stockage à ouvrir.

[in] grfMode

Valeur qui spécifie le mode d’accès à utiliser pour ouvrir l’objet de stockage. Le mode d’accès le plus courant, tiré des constantes STGM, est STGM_READ.

[in] asyncFlags

Valeur qui indique si un point de connexion sur un stockage est hérité par ses sous-stockages et flux. ASYNC_MODE_COMPATIBILITY indique que le point de connexion est hérité ; ASYNC_MODE_DEFAULT indique que le point de connexion n’est pas hérité.

[out] ppstgOpen

Pointeur vers la variable de pointeur IStorage* qui reçoit le pointeur d’interface vers l’objet de stockage asynchrone racine.

Valeur retournée

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

Remarques

Le stockage racine de l’objet de stockage asynchrone est ouvert en fonction du mode d’accès dans le paramètre grfMode . Un pointeur vers l’interface IStorage sur l’objet de stockage ouvert est fourni via le paramètre ppstgOpen .

L’objet wrapper de tableau d’octets doit avoir été instancié précédemment par un appel à la fonction StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes ne prend pas en charge le mode d’accès prioritaire ni les exclusions. Sinon, il fonctionne de la même manière que la fonction StgOpenStorageOnILockBytes .

L’objet de stockage retourné a un point de connexion pour IProgressNotify.