Compartilhar via

Função de retorno de chamada JET_PFNREALLOC

  • Artigo

Aplica-se a: Windows | Windows Server

Função de retorno de chamada JET_PFNREALLOC

A função JET_PFNREALLOC é um retorno de chamada compatível com realocação usado por JetEnumerateColumns para alocar memória para seus buffers de saída.

    void * JET_API JET_PFNREALLOC(
      [in]                 void* pvContext,
      [in]                 void* pv,
      [in]                 unsigned long cb
    );

Parâmetros

pvContext

O ponteiro de contexto fornecido a JetEnumerateColumns. Esse ponteiro de contexto pode ser usado para transmitir o estado do chamador de JetEnumerateColumns para a implementação desse retorno de chamada.

pv

Se não for NULL, especificará um ponteiro para um bloco de memória alocado anteriormente por esse retorno de chamada. Se NULL, um novo bloco de memória do tamanho solicitado será alocado.

cb

O novo tamanho do bloco de memória em bytes. Se esse parâmetro for 0 (zero) e um bloco de memória for especificado, esse bloco de memória será liberado.

Valor Retornado

O sistema pode gerar códigos de êxito ou falha como resultado de uma chamada para essa função. Para obter informações sobre como retornar esses códigos como HRESULTs, consulte Erros extensíveis do mecanismo de armazenamento.

Código de retorno

Descrição

Êxito

Se um bloco de memória alocado anteriormente tiver sido especificado e um novo tamanho de zero tiver sido especificado, esse bloco será liberado e NULL será retornado. Se um bloco de memória alocado anteriormente tiver sido especificado e um novo tamanho diferente de zero tiver sido especificado, o bloco de memória realocada será retornado. Se nenhum bloco de memória tiver sido especificado, um bloco de memória recém-alocado do tamanho especificado será retornado.

Falha

NULL será retornado. Se um bloco de memória alocado anteriormente tiver sido fornecido, esse bloco permanecerá alocado.

Requisitos

Requisito Valor

Cliente

Requer Windows Vista, Windows XP ou Windows 2000 Professional.

Servidor

Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.

Cabeçalho

Declarado em Esent.h.

Consulte Também

JetEnumerateColumns