Méthode IShellBrowser ::GetViewStateStream (shobjidl_core.h)

Obtient une interface IStream qui peut être utilisée pour le stockage des informations d’état spécifiques à l’affichage.

Syntaxe

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

Paramètres

grfMode

Type : DWORD

Accès en lecture/écriture de l’interface IStream . Il peut s’agir de l’une des valeurs suivantes.

STGM_READ

Demande un IStream adapté à la lecture.

STGM_WRITE

Demande un IStream adapté à l’écriture.

STGM_READWRITE

Demande un IStream adapté à la lecture et à l’écriture.

ppStrm

Type : IStream**

Adresse qui reçoit le pointeur d’interface IStream .

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par COM dans le cas contraire.

Remarques

Cette méthode permet d’enregistrer et de restaurer l’état persistant d’une vue (les positions des icônes, les largeurs de colonne et la position de défilement actuelle, par exemple).

Remarques relatives à l’appel d’applications

Utilisez GetViewStateStream lorsque l’affichage est en cours de création pour lire l’état d’affichage enregistré et également lorsque l’affichage est fermé pour enregistrer les modifications apportées à l’état d’affichage. En règle générale, la vue appelle cette méthode avec STGM_READ lors de la création d’une fenêtre d’affichage et avec STGM_WRITE lorsque la méthode SaveViewState de son interface IShellView est appelée.

Remarques aux implémenteurs

Chaque vue Shell doit avoir son propre flux d’affichage. Windows Explorer implémente une liste de flux d’affichage récemment utilisés (MRU) qui sont stockés par utilisateur dans le Registre.

Voir aussi IShellBrowser

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)