Compartir a través de

función de devolución de llamada de JET_PFNREALLOC

  • Artículo

Se aplica a: Windows | Windows Server

función de devolución de llamada de JET_PFNREALLOC

La función JET_PFNREALLOC es una devolución de llamada compatible con reasignación usada por JetEnumerateColumns para asignar memoria para sus búferes de salida.

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

Parámetros

pvContext

Puntero de contexto dado a JetEnumerateColumns. Este puntero de contexto se puede usar para transmitir el estado del autor de la llamada de JetEnumerateColumns a la implementación de esta devolución de llamada.

pv

Si no es NULL, especifica un puntero a un bloque de memoria asignado previamente por esta devolución de llamada. Si es NULL, se asignará un nuevo bloque de memoria del tamaño solicitado.

cb

Nuevo tamaño del bloque de memoria en bytes. Si este parámetro es 0 (cero) y se especifica un bloque de memoria, ese bloque de memoria se liberará.

Valor devuelto

El sistema puede generar códigos de éxito o error como resultado de una llamada a esta función. Para obtener información sobre cómo devolver estos códigos como HRESULT, consulte Errores de motor de almacenamiento extensible.

Código devuelto

Descripción

Correcto

Si se especificó un bloque de memoria asignado anteriormente y se especificó un nuevo tamaño de cero, ese bloque se libera y se devolverá NULL. Si se especificó un bloque de memoria asignado anteriormente y se especificó un nuevo tamaño distinto de cero, se devuelve el bloque de memoria reasignado. Si no se especificó ningún bloque de memoria, se devuelve un bloque de memoria recién asignado del tamaño especificado.

Error

Se devolverá NULL. Si se proporcionó un bloque de memoria asignado anteriormente, ese bloque permanecerá asignado.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista, Windows XP o Windows 2000 Professional.

Servidor

Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Encabezado

Declarado en Esent.h.

Consulte también

JetEnumerateColumns