StgOpenLayoutDocfile-Funktion (objbase.h)

Artikel
02/29/2024

Wird nicht unterstützt.

Die StgOpenLayoutDocfile-Funktion öffnet eine zusammengesetzte Datei in einer ILockBytes-Implementierung , die In der Lage ist, Sektordaten zu überwachen. Zum Aufrufen von StgOpenLayoutDocfile sind sowohl DfLayout.dll als auch DfLayout.lib erforderlich.

Hinweis Verwenden Sie diese Funktion nicht. Verwenden Sie stattdessen die IStorage::CopyTo-Methode . CopyTo kann verwendet werden, um eine Dokumentdatei zu layouten, wodurch die Leistung in den meisten Szenarien verbessert wird.

Syntax

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

Parameter

[in] pwcsDfName

Ein Zeiger auf den Namen der unicode-Zeichenfolge mit NULL-Beendigung der verbundigen Datei, die geöffnet werden soll.

[in] grfMode

Zugriffsmodus, der beim Öffnen des neu erstellten Speicherobjekts verwendet werden soll. Werte werden den STGM-Konstanten entnommen. Beachten Sie, dass Prioritätsmodus und Ausschlüsse nicht unterstützt werden. Der am häufigsten verwendete Zugriffsmodus ist wahrscheinlich STGM_DIRECT | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

Für die zukünftige Verwendung reserviert.

[out] ppstgOpen

Ein Zeiger auf die IStorage-Zeigervariable , die den Schnittstellenzeiger auf das Stammobjekt des neu erstellten Stammspeicherobjekts empfängt.

Rückgabewert

Diese Funktion unterstützt die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL zusätzlich zu folgenden Werten:

Die StgOpenLayoutDocfile-Funktion kann auch jeden der von der StgOpenStorageOnILockBytes-Funktion zurückgegebenen Fehlerwerte zurückgeben.

Hinweise

Die von dieser Funktion erstellte Zusammengesetzte Dateiimplementierung macht die ILayoutStorage-Schnittstelle im Stammspeicher verfügbar. Anwendungen verwenden diese Schnittstelle, um das optimale Layout ihrer zusammengesetzten Dateien auszudrücken, um Daten schneller herunterzuladen und über einen langsamen Link zu rendern. StgOpenLayoutDocfile gibt einen Zeiger auf die IStorage-Schnittstelle im Stammspeicher der neu erstellten Zusammengesetzten Datei zurück. Mit diesem Zeiger rufen Anwendungen QueryInterface auf, um einen Zeiger auf ILayoutStorage abzurufen.