IOleItemContainer ::GetObjectStorage, méthode (oleidl.h)

Article
03/04/2024

Récupère un pointeur vers le stockage pour l’objet spécifié.

Syntaxe

HRESULT GetObjectStorage(
  [in]  LPOLESTR pszItem,
  [in]  IBindCtx *pbc,
  [in]  REFIID   riid,
  [out] void     **ppvStorage
);

Paramètres

[in] pszItem

Nom du document composé pour l’objet dont le stockage est demandé.

[in] pbc

Pointeur vers l’interface IBindCtx sur le contexte de liaison à utiliser dans cette opération de liaison. Le contexte de liaison met en cache les objets liés pendant le processus de liaison, contient des paramètres qui s’appliquent à toutes les opérations utilisant le contexte de liaison et fournit les moyens par lesquels l’implémentation de liaison doit récupérer des informations sur son environnement.

[in] riid

Référence à l’identificateur de l’interface à utiliser pour communiquer avec l’objet, généralement IStorage.

[out] ppvStorage

Adresse d’une variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvStorage contient le pointeur d’interface demandé vers le stockage pour l’objet nommé par pszItem. En cas de réussite, l’implémentation doit appeler AddRef sur *ppvStorage ; il incombe à l’appelant d’appeler Release. Si une erreur se produit, *ppvStorage est défini sur NULL.

Valeur retournée

Cette méthode peut retourner la valeur de retour standard E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	La méthode réussit complètement.
MK_E_OBJECT	Le paramètre pszItem n’identifie pas d’objet dans ce conteneur.
MK_E_NOSTORAGE	L’objet n’a pas son propre stockage indépendant.
E_NOINTERFACE	L’interface demandée n’est pas disponible.

Remarques

L’implémentation du moniker d’élément d’IMoniker ::BindToStorage appelle cette méthode.

Notes aux implémenteurs

Si pszItem désigne un pseudo-objet, votre implémentation de IOleItemContainer ::GetObjectStorage doit retourner MK_E_NOSTORAGE, car les pseudo-objets n’ont pas leur propre stockage indépendant. Si pszItem désigne un objet incorporé ou une partie du document qui a son propre stockage, votre implémentation doit retourner le pointeur d’interface spécifié sur l’objet de stockage approprié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h

Voir aussi

IOleItemContainer

Partager via