funzione callback JET_PFNREALLOC

  • Articolo

Si applica a: Windows | Windows Server

funzione callback JET_PFNREALLOC

La funzione JET_PFNREALLOC è un callback compatibile con realloc usato da JetEnumerateColumns per allocare la memoria per i buffer di output.

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

Parametri

pvContext

Puntatore di contesto assegnato a JetEnumerateColumns. Questo puntatore di contesto può essere usato per trasmettere lo stato dal chiamante di JetEnumerateColumns all'implementazione di questo callback.

Pv

Se non NULL, specifica un puntatore a un blocco di memoria allocato in precedenza da questo callback. Se NULL, verrà allocato un nuovo blocco di memoria delle dimensioni richieste.

Cb

Nuova dimensione del blocco di memoria in byte. Se questo parametro è 0 (zero) e viene specificato un blocco di memoria, tale blocco di memoria verrà liberato.

Valore restituito

Il sistema può generare codici di esito positivo o di errore in seguito a una chiamata a questa funzione. Per informazioni su come restituire questi codici come HRESULTs, vedere Errori del motore di archiviazione estendibili.

Codice restituito

Descrizione

Operazione completata

Se è stato specificato un blocco di memoria allocato in precedenza e viene specificata una nuova dimensione di zero, tale blocco viene liberato e verrà restituito NULL. Se è stato specificato un blocco di memoria allocato in precedenza e sono state specificate nuove dimensioni non zero, viene restituito il blocco di memoria riallocato. Se non è stato specificato alcun blocco di memoria, viene restituito un blocco di memoria appena allocato delle dimensioni specificate.

Operazioni non riuscite

Verrà restituito NULL. Se è stato fornito un blocco di memoria allocato in precedenza, tale blocco rimarrà allocato.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

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

Intestazione

Dichiarato in Esent.h.

Vedere anche

JetEnumerateColumns