Método IMalloc::Alloc (objidl.h)

  • Artigo

Aloca um bloco de memória.

Sintaxe

void * Alloc(
  [in] SIZE_T cb
);

Parâmetros

[in] cb

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

Retornar valor

Se o método for bem-sucedido, o valor retornado será um ponteiro para o bloco de memória alocado. Caso contrário, ele será NULL.

Os aplicativos devem sempre marcar o valor retornado desse método, mesmo ao solicitar pequenas quantidades de memória, pois não há garantia de que a memória será alocada.

Comentários

O conteúdo inicial do bloco de memória retornado é indefinido e não há nenhuma garantia de que o bloco foi inicializado, portanto, você deve inicializá-lo em seu código. O bloco alocado pode ser maior que os bytes cb devido ao espaço necessário para alinhamento e para informações de manutenção.

Se cb for zero, Alloc alocará um item de comprimento zero e retornará um ponteiro válido para esse item. Se não houver memória suficiente disponível, Alloc retornará NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 objidl.h

Confira também

Cotaskmemalloc

Imalloc