Função WsCreateHeap (webservices.h)

  • Artigo
  • 2 minutos para o fim da leitura

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 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 ao tamanho desejado.

 

[in, optional] properties

Reservado para uso futuro; definido como NULL.

[in] propertyCount

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

heap

Com ê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 retorna um código de erro HRESULT.

Comentários

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

A criação de um novo 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

   
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