Método Marshal.ReAllocHGlobal (IntPtr, IntPtr)

Artigo
04/16/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Redimensiona um bloco de memória alocado anteriormente com AllocHGlobal.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

[SecurityCriticalAttribute]
public static IntPtr ReAllocHGlobal(
    IntPtr pv,
    IntPtr cb
)

public:
[SecurityCriticalAttribute]
static IntPtr ReAllocHGlobal(
    IntPtr pv,
    IntPtr cb
)

[<SecurityCriticalAttribute>]
static member ReAllocHGlobal : 
        pv:nativeint *
        cb:nativeint -> nativeint

<SecurityCriticalAttribute>
Public Shared Function ReAllocHGlobal (
    pv As IntPtr,
    cb As IntPtr
) As IntPtr

Parâmetros

pv
Type: System.IntPtr

Um ponteiro para a memória alocada com AllocHGlobal.

cb
Type: System.IntPtr

O novo tamanho do bloco alocado. Este não é um ponteiro; é a contagem de bytes que você está solicitando, convertido para tipo IntPtr. Se você transmitir um ponteiro, ele será tratado como um tamanho.

Valor Retornado

Type: System.IntPtr

Um ponteiro para a memória realocada. Essa memória deve ser liberada usando Marshal.FreeHGlobal.

Exceções

Exception	Condition
OutOfMemoryException	Não há memória suficiente para atender à solicitação.

Comentários

ReAllocHGlobalé um de realocação de memória de dois métodos de API no Marshal classe. (Marshal.ReAllocCoTaskMem é outro.)

Esse método expõe o Win32 GlobalReAlloc função Kernel32. O ponteiro retornado pode ser diferente do original. Se ele for diferente, o conteúdo do bloco de memória original foram copiado para o novo bloco e o bloco de memória original foi liberado.

Segurança

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Informações de Versão

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Windows Phone
Disponível desde 8.1

Confira Também

ReAllocCoTaskMem
FreeHGlobal
Classe Marshal
Namespace System.Runtime.InteropServices
GlobalAlloc Function

Retornar ao início

Compartilhar via