JET_PFNREALLOC Rückruffunktion

Gilt für: Windows | Windows Server

JET_PFNREALLOC Rückruffunktion

Die JET_PFNREALLOC ist ein realloc-kompatibler Rückruf, der von JetEnumerateColumns verwendet wird, um Arbeitsspeicher für die Ausgabepuffer zu reservieren.

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

Parameter

pvContext

Der Kontextzeiger, der JetEnumerateColumns gegeben wird. Dieser Kontextzeiger kann verwendet werden, um den Zustand vom Aufrufer von JetEnumerateColumns an die Implementierung dieses Rückrufs zu übermitteln.

Pv

Wenn nicht NULL, gibt einen Zeiger auf einen Speicherblock an, der zuvor von diesem Rückruf zugeordnet wurde. Bei NULL wird ein neuer Speicherblock der angeforderten Größe zugeordnet.

Cb

Die neue Größe des Speicherblocks in Bytes. Wenn dieser Parameter 0 (null) ist und ein Speicherblock angegeben wird, wird dieser Speicherblock frei.

Rückgabewert

Das System kann Erfolgs- oder Fehlercodes als Ergebnis eines Aufrufs dieser Funktion generieren. Informationen zum Zurückgeben dieser Codes als HRESULTs finden Sie unter Extensible Storage Engine Errors.

Rückgabecode

Beschreibung

Erfolg

Wenn ein zuvor zugeordneter Speicherblock angegeben wurde und eine neue Größe von 0 angegeben wurde, wird dieser Block frei, und NULL wird zurückgegeben. Wenn ein zuvor zugeordneter Speicherblock angegeben wurde und eine neue Größe nicht 0 (null) angegeben wurde, wird der neu zugeordnete Speicherblock zurückgegeben. Wenn kein Speicherblock angegeben wurde, wird ein neu zugeordneter Speicherblock der angegebenen Größe zurückgegeben.

Fehler

NULL wird zurückgegeben. Wenn ein zuvor zugeordneter Speicherblock bereitgestellt wurde, bleibt dieser Block zugeordnet.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

Header

Wird in Esent.h deklariert.

Weitere Informationen

JetEnumerateColumns