_malloca

Aloca memória na pilha.Esta é uma versão de _alloca com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

void *_malloca( 
   size_t size 
);

Parâmetros

  • size
    Bytes a ser alocada da pilha.

Valor de retorno

The _malloca rotina retorna uma void ponteiro para o espaço alocado, tem a garantia de ser alinhadas adequadamente para o armazenamento de qualquer tipo de objeto. If size é 0, _malloca aloca um item de comprimento zero e retorna um ponteiro válido para esse item.

Uma exceção de estouro de pilha é gerada se o espaço não pode ser alocado.A exceção de estouro de pilha não é uma exceção de C++; é uma exceção estruturada.Em vez de usar o tratamento de exceção de C++, você deve usar Manipulação de exceção estruturada (SEH).

Comentários

_malloca aloca size bytes da pilha do programa ou o heap se a solicitação excede um determinado dimensionar em bytes fornecido pelo _ALLOCA_S_THRESHOLD. A diferença entre _malloca e _alloca é o _alloca sempre aloca na pilha, independentemente do dimensionar. Ao contrário de _alloca, que não exigem ou permite uma telefonar para free Para liberar a memória alocada por isso, _malloca requer o uso de _freea Para liberar memória. No modo de depurar, _malloca sempre aloca memória do heap.

Há restrições para chamar explicitamente _malloca em um manipulador de exceção (EH). Rotinas EH executados no x86 - classe processadores operam em seu próprio quadro de memória: Eles executam suas tarefas no espaço de memória que não esteja baseado no local corrente do ponteiro de pilha da função delimitador.Implementações mais comuns incluem o Windows NT estruturada (SEH) de manipulação de exceção e expressões de cláusula catch C++.Portanto, chamar explicitamente _malloca em qualquer um dos seguintes resultados cenários em falha de programa durante o retorno para chamar a rotina EH:

  • Expressão de filtro de exceção SEH Windows NT: __except (_malloca () )

  • Manipulador de exceção final de SEH do Windows NT: __finally {_malloca () }

  • Expressão de cláusula catch C++ EH

No entanto, _malloca pode ser chamado diretamente a partir de uma rotina de EH ou de um retorno de chamada fornecido pelo aplicativo que é invocado por um dos cenários de EH listados anteriormente.

Observação de segurança:

No Windows XP, se _malloca é chamado dentro de um bloco try/catch, você deve chamar _resetstkoflw no bloco catch.

Juntamente com as restrições acima, ao usar o CLR (common linguagem tempo de execução Compilation) option, _malloca não pode ser usado em __except blocos. Para obter mais informações, consulte /CLR restrições.

Requisitos

Rotina

Cabeçalho necessário

_malloca

<malloc.h>

Exemplo

// crt_malloca_simple.c
#include <stdio.h>
#include <malloc.h>

void Fn()
{
   char * buf = _malloca( 100 );
   // do something with buf
   _freea( buf );
}

int main()
{
   Fn();
}

// crt_malloca_exception.c
// This program demonstrates the use of
// _malloca and trapping any exceptions
// that may occur.

#include <windows.h>
#include <stdio.h>
#include <malloc.h>

int main()
{
    int     size;
    int     numberRead = 0;
    int     errcode = 0;
    void    *p = NULL;
    void    *pMarker = NULL;

    while (numberRead == 0)
    {
        printf_s("Enter the number of bytes to allocate "
                 "using _malloca: ");
        numberRead = scanf_s("%d", &size);
    }

    // Do not use try/catch for _malloca,
    // use __try/__except, since _malloca throws
    // Structured Exceptions, not C++ exceptions.

    __try
    {
        if (size > 0)
        {
            p =  _malloca( size );
        }
        else
        {
            printf_s("Size must be a positive number.");
        }
        _freea( p );
    }

    // Catch any exceptions that may occur.
    __except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
    {
        printf_s("_malloca failed!\n");

        // If the stack overflows, use this function to restore.
        errcode = _resetstkoflw();
        if (errcode)
        {
            printf("Could not reset the stack!");
            _exit(1);
        }
    };
}

1000

Enter the number of bytes to allocate using _malloca: 1000 Allocated 1000 bytes of stack at 0x0012FAC4

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Alocação de memória

calloc

malloc

realocar

_resetstkoflw