SHGetMalloc 函式 (shlobj_core.h)

[SHGetMalloc 可透過 Windows Vista 和 Windows Server 2003 取得，但在後續版本的操作系統或產品中可能會變更或無法使用。 如需替代建議，請參閱一節。]

擷取殼層 IMalloc 介面的指標。

語法

SHSTDAPI SHGetMalloc(
  IMalloc **ppMalloc
);

參數

ppMalloc

類型： LPMALLOC*

接收殼層 IMalloc 介面指標的指標的指標位址。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

SHGetMalloc 是在 Windows 95 和 Microsoft Windows NT 4.0 中引進，但從 Windows 2000 開始，就不再需要了。 在其位置中，程式可以呼叫對等 (，而且更容易使用) CoTaskMemAlloc 和 CoTaskMemFree。 如果您發現建議或甚至需要使用 SHGetMalloc的舊版參考檔，則可以接受並鼓勵改用 CoTaskMemAlloc 和 CoTaskMemFree 。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (4.0 版或更新版本)