ExpertAllocMemory fonction)

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

Syntaxe

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

Paramètres

hExpertKey

Identificateur d’expert unique. Moniteur réseau transmet hExpertKey à l’expert lorsqu’il appelle la fonction Run .

nBytes [ dans]

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

perror [ à]

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 le nettoyer et le renvoyer 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.

Remarques

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

Configuration requise

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