Condividi tramite


Funzione GetNPPBlobFromUI

La funzione GetNPPBlobFromUI seleziona una scheda di interfaccia di rete di registro.

Sintassi

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

Parametri

hwnd [in]

Handle di una finestra che visualizza la finestra di dialogo Seleziona una rete .

hFilterBlob [in]

Handle per un BLOB di filtro usato per limitare le schede di interfaccia di rete visualizzate.

phBlob [out]

Puntatore all'handle del BLOB che rappresenta la scheda di interfaccia di rete selezionata.

Valore restituito

Se la funzione ha esito positivo (l'utente seleziona una scheda di interfaccia di rete), il valore restituito è NMERR_SUCCESS e il BLOB a cui punta phBlob viene compilato.

Se l'utente non seleziona una scheda di interfaccia di rete, il valore restituito è NMERR_NO_NPP_SELECTED.

Se la funzione ha esito negativo, il valore restituito è un altro valore NMERR.

Commenti

Quando viene chiamato, Monitoraggio di rete visualizza la finestra di dialogo Seleziona una rete , che è possibile usare per selezionare una scheda di interfaccia di rete. Il BLOB NPP che rappresenta la scheda di interfaccia di rete viene restituito all'applicazione chiamante.

Se il BLOB denominato da hFilterBlob è un BLOB speciale, il finder tenterà di elaborarlo. Un esempio è una chiamata che in precedenza aveva restituito un BLOB speciale dal gruppo di sicurezza di rete remoto. L'applicazione ha inserito il tag obbligatorio MACHINE_NAME. In questo caso, il finder passerà questo BLOB al NPP remoto, che restituirà quindi una tabella di BLOB NPP che rappresenta il computer richiesto. Questi BLOB NPP remoti verranno visualizzati nella finestra di dialogo.

Il chiamante deve chiamare la funzione DestroyBlob , che elimina il BLOB restituito quando non è più necessario.

Per altre informazioni su Vedere
Tre modi per selezionare le schede di interfaccia di rete Selezione di una scheda di interfaccia di rete
Specifica di un BLOB di filtro Specifica di un BLOB di filtro

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Netmon.h
Libreria
Npptools.lib
DLL
Npptools.dll

Vedi anche

GetNPPBlobTable

SelectNPPBlobFromTable