GetNPPBlobTable function

The GetNPPBlobTable function retrieves an NPP BLOB table that represents the register NICs on the local computer.

Syntax

DWORD GetNPPBlobTable(
  _In_  HBLOB       hFilterBlob,
  _Out_ PBLOB_TABLE *ppBlobTable
);

Parameters

hFilterBlob [in]

Handle to a filter BLOB that limits the NPP BLOBs returned in the table.

ppBlobTable [out]

Pointer to a BLOB_TABLE structure that contains at least one BLOB pointer.

Return value

If the function is successful, the return value is NMERR_SUCCESS.

If the function is unsuccessful, the return value is one of the following error codes:

Return code Description
NMERR_NO_NPP_DLL
No DLLs were found in the NPP directory.
NMERR_NO_VALID_NPP_DLLS
None of the DLLs in the NPP directory were valid NPP DLLs.
NMERR_NO_MATCHING_NPPS
NPP BLOBs were discovered, but none passed the filter test.
NMERR_OUT_OF_MEMOR
Network Monitor was not able to allocate memory.

Remarks

The BLOB named by hFilterBlob can also be a special BLOB.

If you set the flag in the filter BLOB to TRUE, the returned BLOB table can also include special BLOBs .

If the BLOB named by hFilterBlob is a special BLOB, the Network Monitor UI will attempt to process it. For example, suppose that a previous call returns a special BLOB from the remote NPP. The application inserts the required tag, MACHINE_NAME. The finder then passes this BLOB to the remote NPP, which then returns a table of the NPP BLOBs associated with the machine name.

To destroy all returned BLOBs and the BLOB table, the caller is responsible for calling the DestroyBlob function.

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
Npptools.lib
DLL
Npptools.dll