rückruffunktion JET_PFNREALLOC
Gilt für: Windows | Windows Server
rückruffunktion JET_PFNREALLOC
Die JET_PFNREALLOC-Funktion ist ein realloc-kompatibler Rückruf, der von JetEnumerateColumns verwendet wird, um Arbeitsspeicher für die Ausgabepuffer zuzuweisen.
void * JET_API JET_PFNREALLOC(
[in] void* pvContext,
[in] void* pv,
[in] unsigned long cb
);
Parameter
pvContext
Der Kontextzeiger für JetEnumerateColumns. 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 durch diesen Rückruf zugewiesen 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 freigegeben.
Rückgabewert
Das System generiert möglicherweise Erfolgs- oder Fehlercodes als Ergebnis eines Aufrufs dieser Funktion. Informationen zum Zurückgeben dieser Codes als HRESULTs finden Sie unter Fehler der erweiterbaren Speicher-Engine.
Rückgabecode |
Beschreibung |
|---|---|
Erfolg |
Wenn ein zuvor zugewiesener Speicherblock angegeben wurde und eine neue Größe von 0 angegeben wurde, wird dieser Block freigegeben, und NULL wird zurückgegeben. Wenn ein zuvor zugeordneter Speicherblock angegeben wurde und eine neue Größe ungleich 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 zugewiesener 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. |
Kopfzeile |
Deklariert in Esent.h. |