Função WsAlloc (webservices.h)

Aloca um segmento de memória do heap especificado.

Sintaxe

HRESULT WsAlloc(
  [in]           WS_HEAP  *heap,
  [in]           SIZE_T   size,
                 void     **ptr,
  [in, optional] WS_ERROR *error
);

Parâmetros

[in] heap

Ponteiro para uma estrutura WS_HEAP que representa o heap do qual alocar a memória.

[in] size

O número de bytes a serem alocados. Esse valor pode ser zero.

ptr

Em caso de êxito, um ponteiro que recebe o endereço da memória alocada. Esse ponteiro é válido até que WsFreeHeap ou WsResetHeap seja chamado no heap.

O ponteiro retornado é alinhado em um limite de 8 bytes.

Alocações de bytes zero retornarão um ponteiro não NULL.

[in, optional] error

Ponteiro para uma estrutura de 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.

Código de retorno	Descrição
WS_E_QUOTA_EXCEEDED	Os bytes solicitados, além de bytes já alocados, excedem o tamanho do heap, conforme especificado pela propriedade WS_HEAP_PROPERTY_MAX_SIZE .
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.

Comentários

A memória retornada por essa função não é inicializada como zero e contém valores indefinidos.

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