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. |