Compartilhar via


Função AllocADsMem (adshlp.h)

A função AllocADsMem aloca um bloco de memória do tamanho especificado.

Sintaxe

LPVOID AllocADsMem(
  [in] DWORD cb
);

Parâmetros

[in] cb

Tipo: DWORD

Contém o tamanho, em bytes, a ser alocado.

Retornar valor

Tipo: LPVOID

Quando bem-sucedida, a função retorna um ponteiro não NULL para a memória alocada. O chamador deve liberar essa memória quando ela não for mais necessária passando o ponteiro retornado para FreeADsMem.

Retorna NULL se não for bem-sucedido. Chame ADsGetLastError para obter um erro estendido status. Para obter mais informações sobre valores de código de erro, consulte Códigos de erro ADSI.

Comentários

O bloco de memória retornado por AllocADsMem é inicializado como zero.

Para obter mais informações e um exemplo de código que mostra como usar a função AllocADsMem , consulte ReallocADsMem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho adshlp.h
Biblioteca Activeds.lib
DLL Activeds.dll; AdsLdpc.dll

Confira também

Códigos de erro ADSI

Funções ADSI

ADsGetLastError

FreeADsMem

ReallocADsMem