GetHGlobalFromILockBytes-Funktion (coml2api.h)
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 |