ExpertReallocMemory function

The ExpertReallocMemory function increases or decreases the amount of memory allocated by Network Monitor.

Syntax

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

Parameters

hExpertKey [in]

Unique identifier passed to the expert at Run or Configure.

pOriginalMemory [in]

Pointer to the memory allocated by Network Monitor. The pOriginalMemory pointer can be returned by a previous call to ExpertAllocMemory or ExpertReallocMemory.

nBytes [in]

Size of reallocated memory.

pError [out]

On return, an error code if the function fails. If the error code is NMERR_EXPERT_TERMINATE, the expert must clean up and return immediately.

Return value

If the function is successful, the return value is a pointer to the allocated memory.

If the function is unsuccessful, the return value is NULL, and pError (if it is a non-NULL value) indicates the reason for the failure.

Remarks

It is important to note that an expert should use the Network Monitor memory allocation functions for memory management. If your expert fails during run time, using these functions will allow Network Monitor to free the memory it has allocated.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Netmon.h
Library	Nmapi.lib
DLL	Nmapi.dll