GetNPPBlobFromUI

The GetNPPBlobFromUI function selects a register NIC.

DWORDGetNPPBlobFromUI(HWNDhwnd,
HBLOBhFilterBlob,
HBLOB*phBlob);

Parameters

• hwnd
  [in] A handle to a window that displays the Select a network dialog box.
• hFilterBlob
  [in] A handle to a filter BLOB used to limit which NICs are displayed.
• phBlob
  [out] A pointer to the handle of the BLOB that represents the selected NIC.

Return Values

If the function is successful (the user selects a NIC), the return value is NMERR_SUCCESS, and the BLOB that phBlob points to is filled in.

If the user does not select an NIC, the return value is NMERR_NO_NPP_SELECTED.

If the function is unsuccessful, the return value is another NMERR value.

Remarks

When called, Network Monitor displays the Select a network dialog box, which you can use to select a NIC. The NPP BLOB that represents the NIC is returned to the calling application.

If the BLOB named by hFilterBlob is a special BLOB, the finder will attempt to process it. An example would be a call that had previously returned a special BLOB from the remote NPP. The application inserted the required tag, MACHINE_NAME. In this situation, the finder would pass this BLOB to the remote NPP, which would then return a table of NPP BLOBs representing the machine requested. These remote NPP BLOBs would appear in the dialog box.

The caller must call the DestroyBlob function, which destroys the returned BLOB when it is no longer required.

Requirements

See Also

GetNPPBlobTable, SelectNPPBlobFromTable