HrIStorageFromStream

S’applique à : Outlook 2013 | Outlook 2016

Couche une interface IStorage sur un objet IStream .

Propriété	Valeur
Fichier d’en-tête :	Mapiutil.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

HRESULT HrIStorageFromStream(
  LPUNKNOWN lpUnkIn,
  PIID lpInterface,
  ULONG ulFlags,
  LPSTORAGE FAR * lppStorageOut
);

Paramètres

lpUnkIn

[in] Pointeur vers l’objet IUnknown implémentant IStream.

lpInterface

[in] Pointeur vers l’identificateur d’interface (IID) de l’objet de flux. L’une des valeurs suivantes peut être passée dans le paramètre lpInterface : NULL, IID_IStream ou IID_ILockBytes. Le passage de NULL dans lpInterface est identique à la transmission d’IID_IStream.

ulFlags

[in] Masque de bits des indicateurs qui contrôle la façon dont l’objet de stockage doit être créé par rapport au flux. Le paramètre par défaut est STGSTRM_RESET, ce qui donne à l’objet de stockage un accès en lecture seule et le démarre à la position zéro du flux. Les indicateurs suivants peuvent être définis dans n’importe quelle combinaison, sauf indication contraire :

STGSTRM_CREATE

Crée un objet de stockage pour l’objet de flux. Cet indicateur ne peut pas être défini si l’indicateur STGSTRM_RESET est défini.

STGSTRM_CURRENT

Démarre le stockage à la position actuelle du flux. Cet indicateur ne peut pas être défini si l’indicateur STGSTRM_RESET est défini.

STGSTRM_MODIFY

Permet au fournisseur de services appelant d’écrire dans le stockage retourné. Cet indicateur ne peut pas être défini si l’indicateur STGSTRM_RESET est défini.

STGSTRM_RESET

Démarre le stockage à la position zéro. Cet indicateur ne peut pas être défini si un autre indicateur est défini.

lppStorageOut

[out] Pointeur vers un pointeur vers l’objet IStorage retourné.

Valeur renvoyée

S_OK

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

Remarques

Les fournisseurs de magasins de messages prennent en charge la fonction HrIStorageFromStream à l’aide de l’interface IStorage pour les pièces jointes. Les fournisseurs de magasins doivent implémenter l’interface IStream . HrIStorageFromStream fournit l’interface IStorage pour l’objet IStream . Il est possible de passer une interface ILockBytes ou IStream dans lpUnkIn.