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. |