CoTaskMemRealloc

9/8/2008

Thisfunction altera o tamanho de um bloco de memória tarefa anteriormente alocado.

Syntax

LPVOID CoTaskMemRealloc(
  LPVOID pv, 
  ULONG cb
); 

Parameters

• Vp
  [no] Void ponteiro para bloco de memória para ser realocado. Ela pode ser uma NULL ponteiro, conforme discutido nos comentários.

• cb
  [no] Tamanho, em bytes, do bloco de memória para ser realocado. Pode ser zero, conforme discutido no seguinte " Comentários ".

Return Value

Um ponteiro para o bloco memória realocada indica sucesso. NULL Indica memória insuficiente, ou que cb é zero e Vp não é NULL.

Remarks

O Vp argumento aponta para início do bloco de memória. Se Vp é NULL, CoTaskMemRealloc Aloca um novo bloco de memória da mesma maneira como o CoTaskMemAlloc função. Se Vp não é NULL, ele deve ser um ponteiro retornado por uma chamar anterior para CoTaskMemAlloc.

O cb argumento especifica o tamanho (em bytes) do novo bloco. O conteúdo de bloco é inalterado up to o menor dos novos e antigos tamanhos, embora o novo bloco pode esteja em uma localidade diferente. Porque o novo bloco pode estar em um posição de memória diferentes, o ponteiro retornado pela CoTaskMemRealloc não é garantida seja o ponteiro passado através de Vp argumento. Se Vp não é NULL e cb for zero, a memória apontado pelo Vp é liberado.

CoTaskMemRealloc Retorna um ponteiro void ao bloco de memória realocada (e possivelmente movidos). É a valor de retorno NULL se o tamanho é zero e o argumento reserva não for NULL, ou se não houver memória suficiente disponível para expansão de bloco para o tamanho especificado. Na maiúsculas e minúsculas, o original primeira bloco é liberado; Na segunda, o original é bloco inalterado.

Espaço de armazenamento apontado pelo valor de retorno é garantido ser alinhado adequadamente para armazenamento de qualquer tipo de objeto. Para get um ponteiro para um tipo Other Than Void, use um coerção de tipo o valor de retorno.

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

See Also

Reference

CoTaskMemAlloc