StgGetIFillLockBytesOnFile-Funktion (objbase.h)

Artikel
03/06/2024

[Die StgGetIFillLockBytesOnFile-Funktion ist veraltet. Die folgenden Informationen werden bereitgestellt, um Versionen von Windows vor Windows 2000 zu unterstützen.]

Die StgGetIFillLockBytesOnFile-Funktion öffnet ein Wrapperobjekt in einer temporären Datei.

Syntax

HRESULT StgGetIFillLockBytesOnFile(
  [in]  OLECHAR const  *pwcsName,
  [out] IFillLockBytes **ppflb
);

Parameter

[in] pwcsName

Ein Zeiger auf den Unicode-Zeichenfolgennamen der Datei, für die ein Wrapperobjekt erstellt wird.

[out] ppflb

Ein Zeiger auf die IFillLockBytes*-Zeigervariable, die den Schnittstellenzeiger auf das neue Bytearray-Wrapperobjekt empfängt.

Rückgabewert

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

Die StgGetIFillLockBytesOnFile-Funktion kann auch alle Dateisystemfehler zurückgeben.

Hinweise

Der Moniker, der das Herunterladen der in pwcsName angegebenen Datei verwaltet, ruft diese Funktion im Zuge der Erstellung des asynchronen Speichers auf, der zum Verwalten des asynchronen Herunterladens von Daten erforderlich ist. Der Moniker erstellt zunächst eine temporäre Datei und ruft dann diese Funktion auf, um das Wrapperobjekt für diese Datei zu erstellen. Schließlich ruft der Moniker StgOpenAsyncDocfileOnIFillLockBytes auf, um den Stammspeicher der Verbunddatei zu öffnen, die in die temporäre Datei heruntergeladen werden soll.