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 |