Share via


GetNPPBlobTable

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

DWORDGetNPPBlobTable(HBLOBhFilterBlob,
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 Values

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

Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header

Declared in Netmon.h.

Library

Link to Npptools.lib.

DLL Requires Npptools.dll.