Compartilhar via


Função CoTaskMemAlloc (combaseapi.h)

Aloca um bloco de memória de tarefa da mesma forma que IMalloc::Alloc .

Sintaxe

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

Parâmetros

[in] cb

O tamanho do bloco de memória a ser alocado, em bytes.

Retornar valor

Se a função for bem-sucedida, ela retornará o bloco de memória alocado. Caso contrário, retornará NULL.

Comentários

CoTaskMemAlloc usa o alocador padrão para alocar um bloco de memória da mesma forma que IMalloc::Alloc . Não é necessário chamar a função CoGetMalloc antes de chamar CoTaskMemAlloc.

O conteúdo inicial do bloco de memória retornado é indefinido – não há nenhuma garantia de que o bloco foi inicializado. O bloco alocado pode ser maior do que os bytes cb devido ao espaço necessário para alinhamento e para informações de manutenção.

Se cb for 0, CoTaskMemAlloc alocará um item de comprimento zero e retornará um ponteiro válido para esse item. Se não houver memória suficiente disponível, CoTaskMemAlloc retornará NULL. Os aplicativos devem sempre marcar o valor retornado dessa função, mesmo ao solicitar pequenas quantidades de memória, pois não há garantia de que a memória será alocada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Cotaskmemfree

Cotaskmemrealloc

IMalloc::Alloc