IOleItemContainer ::GetObjectStorage, méthode (oleidl.h)
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 |
---|---|
|
La méthode réussit complètement. |
|
Le paramètre pszItem n’identifie pas d’objet dans ce conteneur. |
|
L’objet n’a pas son propre stockage indépendant. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour