Partager via


Fonction ExpertAllocMemory

La fonction ExpertAllocMemory alloue de la mémoire pour l’expert.

Syntaxe

LPVOID WINAPI ExpertAllocMemory(
        HEXPERTKEY hExpertKey,
  _In_  SIZE_T     nBytes,
  _Out_ LPDWORD    pError
);

Paramètres

hExpertKey

Identificateur d’expert unique. Network Monitor transmet hExpertKey à l’expert lorsqu’il appelle la fonction Run .

nBytes [in]

Mémoire allouée, mesurée en octets.

pError [out]

Indicateur d’erreur. Si la fonction échoue, le paramètre nBytes contient le code d’erreur. Si le code d’erreur est NMERR_EXPERT_TERMINATE, l’expert doit propre-up et retourner immédiatement.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers la mémoire allouée.

Si la fonction échoue, la valeur de retour est NULL et pError fournit un code d’erreur qui indique la raison de l’échec.

Notes

Il est important de noter qu’un expert doit utiliser les fonctions d’allocation de mémoire du Moniteur réseau (y compris ExpertReallocMemory) pour la gestion de la mémoire. Si votre expert échoue pendant l’exécution, l’utilisation de ces fonctions permet au Moniteur réseau de libérer la mémoire qu’il a allouée.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Netmon.h
Bibliothèque
Nmapi.lib
DLL
Nmapi.dll