JET_PFNREALLOC Callback-Funktion

Artikel
03/05/2015

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Callback-Funktion JET_PFNREALLOC

Die JET_PFNREALLOC-Funktion ist ein kompatibler Realloc -Rückruf Speicher für seine Ausgabepuffer Reservieren von JetEnumerateColumns verwendet.

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

Parameter

pvContext

Der Kontext-Zeiger auf JetEnumerateColumnsangegeben. Dieser Kontext Zeiger kann verwendet werden, den Status der Aufrufer der JetEnumerateColumns für die Implementierung dieses Rückrufs.

Wenn ungleich NULL ist, gibt einen Zeiger auf einen Speicherblock, der von diesem Rückruf bereits zugeordnet. Bei NULL wird der angeforderten Größe ein neuen Speicherblock zugeteilt.

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

Return Value

Das System kann Erfolg oder Misserfolg Codes als Ergebnis eines Aufrufs dieser Funktion generieren. Informationen dazu, wie Sie diese Codes als HRESULTs zurückgeben finden Sie unter Extensible Storage Engine-Fehler.

Rückgabecode	Beschreibung
Success	Wenn ein zuvor reservierten Speicherblock angegeben wurde und eine neue Größe 0 (null) angegeben wurde, Block freigegeben, und NULL zurückgegeben. Wenn ein zuvor reservierten Speicherblock angegeben wurde und eine neue Größe ungleich NULL wurde angegeben, wird neu reservierten Speicherblocks zurückgegeben. Wenn keine Speicherblock angegeben wurde, wird neu reservierten Speicherblock der angegebenen Größe zurückgegeben.
Failure	Es wird NULL zurückgegeben. Wenn zuvor reservierten Speicherblocks bereitgestellt wurde, und dann diesen Block reservierten bleibt.

Success

Wenn ein zuvor reservierten Speicherblock angegeben wurde und eine neue Größe 0 (null) angegeben wurde, Block freigegeben, und NULL zurückgegeben. Wenn ein zuvor reservierten Speicherblock angegeben wurde und eine neue Größe ungleich NULL wurde angegeben, wird neu reservierten Speicherblocks zurückgegeben. Wenn keine Speicherblock angegeben wurde, wird neu reservierten Speicherblock der angegebenen Größe zurückgegeben.

Failure

Es wird NULL zurückgegeben. Wenn zuvor reservierten Speicherblocks bereitgestellt wurde, und dann diesen Block reservierten bleibt.

Voraussetzungen

-Client,	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server.
Kopfzeile	In Esent.h deklariert.

Siehe auch

JetEnumerateColumns

Freigeben über