Função WsCreateHeap (webservices.h)

  • Artigo

Cria um objeto heap .

Sintaxe

HRESULT WsCreateHeap(
  [in]           SIZE_T                 maxSize,
  [in]           SIZE_T                 trimSize,
  [in, optional] const WS_HEAP_PROPERTY *properties,
  [in]           ULONG                  propertyCount,
                 WS_HEAP                **heap,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] maxSize

O número total de bytes que podem ser alocados do heap. O número total de bytes é definido como a soma dos tamanhos passados em todas as chamadas para a função WsAlloc desde que o heap foi criado ou redefinido.

[in] trimSize

O número máximo de bytes de memória que o heap retém depois que o heap foi redefinido por uma chamada para a função WsResetHeap . Esse é um valor de aproximação devido à sobrecarga de heap.

Nota Se o valor de trimSize for maior que o valor de maxSize, o tamanho do heap não será ajustado para o tamanho desejado.

 

[in, optional] properties

Reservado para uso futuro; defina como NULL.

[in] propertyCount

Reservado para uso futuro; definido como 0 (zero).

heap

Em caso de êxito, o ponteiro que recebe o endereço da estrutura WS_HEAP que representa o novo objeto heap.

[in, optional] error

Ponteiro para uma estrutura WS_ERROR que recebe informações de erro adicionais se a função falhar.

Retornar valor

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retornará um código de erro HRESULT.

Comentários

Um heap na API de Serviços Web do Windows é uma alocação de memória usada para mensagens. Os heaps também podem ser usados para armazenar dados de mensagens separadamente do tempo de vida de uma mensagem. Algumas funções de API permitem o controle de heap explícito durante o tempo de vida de qualquer leitura de dados.

A criação de um heap não aloca nenhuma memória (exceto a memória necessária para WS_HEAP própria estrutura). Os parâmetros maxSize e trimSize são usados como cotas somente durante as operações WsAlloc e WsResetHeap .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll