SHGetMalloc-Funktion (shlobj_core.h)

[SHGetMalloc ist über Windows Vista und Windows Server 2003 verfügbar, kann jedoch in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Alternative Empfehlungen finden Sie im Abschnitt Hinweise.]

Ruft einen Zeiger auf die IMalloc-Schnittstelle der Shell ab.

Syntax

SHSTDAPI SHGetMalloc(
  IMalloc **ppMalloc
);

Parameter

ppMalloc

Typ: LPMALLOC*

Die Adresse eines Zeigers, der den IMalloc-Schnittstellenzeiger der Shell empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

SHGetMalloc wurde in Windows 95 und Microsoft Windows NT 4.0 eingeführt, ist aber ab Windows 2000 nicht mehr erforderlich. An seiner Stelle können Programme das entsprechende (und einfacher zu verwendende) CoTaskMemAlloc und CoTaskMemFree aufrufen. Wenn Sie ein älteres Referenzdokument finden, das die Verwendung von SHGetMalloc vorschlägt oder sogar erfordert, ist es akzeptabel und wird empfohlen, stattdessen CoTaskMemAlloc und CoTaskMemFree zu verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 4.0 oder höher)