CoTaskMemAlloc
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função aloca um bloco de memória tarefa.
Syntax
LPVOID CoTaskMemAlloc(
ULONG cb
);
Parameters
- cb
[no] Tamanho, em bytes, do bloco de memória a ser alocada.
Return Value
Um ponteiro para bloco de memória alocada indica sucesso. NULL Indica memória insuficiente.
Remarks
O conteúdo inicial do bloco de memória retornado está indefinido – não há nenhum garante que o bloco foi inicializado. O bloco alocado pode ser maior que cb Bytes because of o espaço exigido para alinhamento e informações manutenção.
Se cb for zero, CoTaskMemAlloc Aloca um item Zero-Length e retorna um válido ponteiro para esse item. Se não houver memória suficiente disponível, CoTaskMemAlloc retorna NULL.
Os aplicativos devem sempre verificar a valor de retorno desse método, mesmo quando solicitar pequenas quantidades de memória, porque não há nenhuma garantia de memória será alocada.
Passando para esta função qualquer inválido e, em algumas circunstâncias, NULL ponteiros resultam em terminação inesperada do aplicativo.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |