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 |