GetHGlobalFromILockBytes-Funktion (coml2api.h)

  • Artikel

Die GetHGlobalFromILockBytes-Funktion ruft ein globales Speicherhandle in ein Bytearrayobjekt ab, das mit der CreateILockBytesOnHGlobal-Funktion erstellt wurde.

Syntax

HRESULT GetHGlobalFromILockBytes(
  [in]  LPLOCKBYTES plkbyt,
  [out] HGLOBAL     *phglobal
);

Parameter

[in] plkbyt

Zeiger auf die ILockBytes-Schnittstelle des byte-array-Objekts, das zuvor durch einen Aufruf der CreateILockBytesOnHGlobal-Funktion erstellt wurde.

[out] phglobal

Zeiger auf das aktuelle Speicherhandle, das vom angegebenen Bytearrayobjekt verwendet wird.

Rückgabewert

Diese Funktion gibt HRESULT zurück.

Hinweise

Nach einem Aufruf von CreateILockBytesOnHGlobal, der ein Bytearrayobjekt im globalen Speicher erstellt, ruft GetHGlobalFromILockBytes einen Zeiger auf das Handle des globalen Arbeitsspeichers ab, der dem Bytearrayobjekt zugrunde liegt. Das Handle, das diese Funktion zurückgibt, unterscheidet sich möglicherweise vom ursprünglichen Handle, da die GlobalReAlloc-Funktion zwischen aufrufen wird.

Der Inhalt des zurückgegebenen Speicherhandles kann in eine sauber Datenträgerdatei geschrieben und dann mit der StgOpenStorage-Funktion als Speicherobjekt geöffnet werden.

Diese Funktion funktioniert nur innerhalb desselben Prozesses, aus dem das Bytearray erstellt wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile coml2api.h (Ole2.h einschließen)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

CreateILockBytesOnHGlobal

StgOpenStorage