Função SetThreadStackGuarantee (processthreadsapi.h)

Define o tamanho mínimo da pilha associada ao thread ou fibra de chamada que estará disponível durante quaisquer exceções de estouro de pilha. Isso é útil para lidar com exceções de estouro de pilha; o aplicativo pode usar com segurança o número especificado de bytes durante o tratamento de exceções.

Sintaxe

BOOL SetThreadStackGuarantee(
  [in, out] PULONG StackSizeInBytes
);

Parâmetros

[in, out] StackSizeInBytes

O tamanho da pilha, em bytes. No retorno, esse valor é definido como o tamanho da pilha anterior, em bytes.

Se esse parâmetro for 0 (zero), a função terá êxito e o parâmetro conterá o tamanho da pilha atual.

Se o tamanho especificado for menor que o tamanho atual, a função terá êxito, mas ignorará essa solicitação. Portanto, você não pode usar essa função para reduzir o tamanho da pilha.

Esse valor não pode ser maior que o tamanho da pilha reservada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero (0). Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se a função for bem-sucedida, o aplicativo poderá lidar com possíveis exceções EXCEPTION_STACK_OVERFLOW usando o tratamento de exceções estruturadas. Para retomar a execução depois de lidar com um estouro de pilha, você deve executar determinadas etapas de recuperação. Se você estiver usando o compilador do Microsoft C/C++, chame a função _resetstkoflw . Se você estiver usando outro compilador, consulte a documentação do compilador para obter informações sobre como se recuperar de estouros de pilha.

Para definir a garantia de pilha para uma fibra, primeiro você deve chamar a função SwitchToFiber para executar a fibra. Depois de definir a garantia para essa fibra, ela é usada pela fibra, independentemente de qual thread executa a fibra.

Requisitos

Confira também

Funções de thread e processo

Tamanho da pilha do thread

Threads

APIs Vertdll disponíveis em enclaves de VBS