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 |
|
| Biblioteca |
|
| Archivo DLL |
|