Méthode ILayoutStorage ::LayoutScript (objidl.h)

La méthode LayoutScript fournit des instructions explicites pour réorganiser les stockages, les flux et les contrôles dans un fichier composé pour qu’ils correspondent à l’ordre dans lequel ils sont accessibles pendant le téléchargement.

Syntaxe

HRESULT LayoutScript(
  [in] StorageLayout *pStorageLayout,
  [in] DWORD         nEntries,
  [in] DWORD         glfInterleavedFlag
);

Paramètres

[in] pStorageLayout

Pointeur vers un tableau de structures StorageLayout .

[in] nEntries

Nombre d’entrées dans le tableau de structures StorageLayout .

[in] glfInterleavedFlag

Réservé pour un usage futur.

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 :

Code de retour	Description
STG_E_INVALIDPOINTER	Le pointeur de disposition du stockage n’est pas valide.
STG_E_INVALIDFLAG	La valeur de glfInterleavedFlag n’est pas valide.
STG_E_PATHNOTFOUND	Le nouveau nom de fichier de document spécifié n’est pas valide.
STG_E_INSUFFICIENTMEMORY	La mémoire disponible est insuffisante pour terminer cette opération.
STG_E_INVALIDPARAMETER	L’un des paramètres n’est pas valide.
STG_E_INUSE	La méthode BeginMonitor a été appelée alors que ILayoutStorage faisait déjà l’objet d’une surveillance.

Remarques

Pour fournir des instructions de disposition explicites, l’application appelle ILayoutStorage ::LayoutScript, en passant un tableau de structures StorageLayout . Chaque structure définit un seul bloc de données de stockage ou de flux et spécifie où le bloc doit être écrit dans le tableau d’octets ILockBytes .

Une application peut combiner la disposition scriptée avec la surveillance, comme la structure d’un fichier composé particulier peut le dicter.

Lorsque le modèle de disposition de données optimal d’un fichier composé entier a été déterminé, l’application appelle ILayoutStorage ::ReLayoutDocfile pour restructurer le fichier composé afin qu’il corresponde à l’ordre dans lequel ses secteurs de données ont été consultés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	objidl.h
Bibliothèque	Uuid.lib
DLL	Ole32.dll

Voir aussi

ILayoutStorage ::ReLayoutDocfile

ILockBytes

StorageLayout