Função SHGetMalloc (shlobj_core.h)

[SHGetMalloc está disponível por meio do Windows Vista e do Windows Server 2003, mas pode ser alterado ou indisponível em versões subsequentes do sistema operacional ou produto. Consulte a seção Comentários para obter recomendações alternativas.]

Recupera um ponteiro para a interface IMalloc do Shell.

Sintaxe

SHSTDAPI SHGetMalloc(
  IMalloc **ppMalloc
);

Parâmetros

ppMalloc

Tipo: LPMALLOC*

O endereço de um ponteiro que recebe o ponteiro da interface IMalloc do Shell.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

SHGetMalloc foi introduzido no Windows 95 e no Microsoft Windows NT 4.0, mas a partir do Windows 2000 não é mais necessário. Em seu lugar, os programas podem chamar coTaskMemAlloc e CoTaskMemFree equivalentes (e mais fáceis de usar). Se você encontrar um documento de referência mais antigo que sugira ou até mesmo exija o uso de SHGetMalloc, é aceitável e incentivado a usar CoTaskMemAlloc e CoTaskMemFree .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 4.0 ou posterior)