fonction de rappel JET_PFNREALLOC
S’applique à : Windows | Windows Server
fonction de rappel JET_PFNREALLOC
La fonction JET_PFNREALLOC est un rappel compatible realloc utilisé par JetEnumerateColumns pour allouer de la mémoire pour ses mémoires tampons de sortie.
void * JET_API JET_PFNREALLOC(
[in] void* pvContext,
[in] void* pv,
[in] unsigned long cb
);
Paramètres
pvContext
Pointeur de contexte donné à JetEnumerateColumns. Ce pointeur de contexte peut être utilisé pour transmettre l’état de l’appelant de JetEnumerateColumns à l’implémentation de ce rappel.
pv
Si elle n’est pas NULL, spécifie un pointeur vers un bloc de mémoire précédemment alloué par ce rappel. Si la valeur est NULL, un nouveau bloc de mémoire de la taille demandée sera alloué.
cb
Nouvelle taille du bloc de mémoire en octets. Si ce paramètre est égal à 0 (zéro) et qu’un bloc de mémoire est spécifié, ce bloc de mémoire est libéré.
Valeur renvoyée
Le système peut générer des codes de réussite ou d’échec à la suite d’un appel à cette fonction. Pour plus d’informations sur la façon de retourner ces codes en tant que HRESULT, consultez Erreurs du moteur de stockage extensible.
Code de retour |
Description |
|---|---|
Succès |
Si un bloc de mémoire précédemment alloué a été spécifié et qu’une nouvelle taille de zéro a été spécifiée, ce bloc est libéré et NULL est retourné. Si un bloc de mémoire précédemment alloué a été spécifié et qu’une nouvelle taille autre que zéro a été spécifiée, le bloc de mémoire réalloué est retourné. Si aucun bloc de mémoire n’a été spécifié, un bloc de mémoire nouvellement alloué de la taille spécifiée est retourné. |
Échec |
La valeur NULL est retournée. Si un bloc de mémoire précédemment alloué a été fourni, ce bloc reste alloué. |
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel. |
Serveur |
Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server. |
En-tête |
Déclaré dans Esent.h. |