Función GetNPPBlobFromUI

La función GetNPPBlobFromUI selecciona una NIC de registro.

Sintaxis

DWORD GetNPPBlobFromUI(
  _In_  HWND  hwnd,
  _In_  HBLOB hFilterBlob,
  _Out_ HBLOB *phBlob
);

Parámetros

hwnd [in]

Identificador de una ventana que muestra el cuadro de diálogo Seleccionar una red .

hFilterBlob [in]

Identificador de un blob de filtro que se usa para limitar qué NIC se muestran.

phBlob [out]

Puntero al identificador del BLOB que representa la NIC seleccionada.

Valor devuelto

Si la función se ejecuta correctamente (el usuario selecciona una NIC), el valor devuelto es NMERR_SUCCESS y el BLOB al que phBlob apunta a se rellena.

Si el usuario no selecciona una NIC, el valor devuelto es NMERR_NO_NPP_SELECTED.

Si la función no se realiza correctamente, el valor devuelto es otro valor NMERR.

Observaciones

Cuando se llama, Network Monitor muestra el cuadro de diálogo Seleccionar una red , que puede usar para seleccionar una NIC. El BLOB de NPP que representa la NIC se devuelve a la aplicación que realiza la llamada.

Si el BLOB llamado por hFilterBlob es un BLOB especial, el buscador intentará procesarlo. Un ejemplo sería una llamada que había devuelto previamente un BLOB especial desde el NPP remoto. La aplicación insertó la etiqueta necesaria, MACHINE_NAME. En esta situación, el buscador pasaría este BLOB al NPP remoto, que luego devolvería una tabla de blobs de NPP que representaba la máquina solicitada. Estos blobs de NPP remotos aparecerían en el cuadro de diálogo.

El llamador debe llamar a la función DestroyBlob , que destruye el BLOB devuelto cuando ya no es necesario.

Para más información sobre	Vea
Tres maneras de seleccionar NIC	Selección de una tarjeta de interfaz de red
Especificación de un blob de filtro	Especificar un BLOB de filtro

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Npptools.lib
Archivo DLL	Npptools.dll

Vea también

GetNPPBlobTable

SelectNPPBlobFromTable