GetNPPBlobFromUI, fonction

La fonction GetNPPBlobFromUI sélectionne une carte réseau de registre.

Syntaxe

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

Paramètres

hwnd [in]

Handle d’une fenêtre qui affiche la boîte de dialogue Sélectionner un réseau .

hFilterBlob [in]

Handle d’un objet BLOB de filtre utilisé pour limiter les cartes réseau affichées.

phBlob [out]

Pointeur vers le handle de l’objet BLOB qui représente la carte réseau sélectionnée.

Valeur retournée

Si la fonction réussit (l’utilisateur sélectionne une carte réseau), la valeur renvoyée est NMERR_SUCCESS et l’objet BLOB vers lequel pointe phBlob est renseigné.

Si l’utilisateur ne sélectionne pas de carte réseau, la valeur de retour est NMERR_NO_NPP_SELECTED.

Si la fonction échoue, la valeur de retour est une autre valeur NMERR.

Notes

Lorsqu’il est appelé, le Moniteur réseau affiche la boîte de dialogue Sélectionner un réseau , que vous pouvez utiliser pour sélectionner une carte réseau. L’objet BLOB NPP qui représente la carte réseau est retourné à l’application appelante.

Si l’objet BLOB nommé par hFilterBlob est un objet BLOB spécial, le chercheur tente de le traiter. Par exemple, un appel qui avait précédemment retourné un objet BLOB spécial à partir du NPP distant. L’application a inséré la balise requise, MACHINE_NAME. Dans ce cas, le chercheur transmettait cet objet BLOB au NPP distant, qui retournerait ensuite une table de objets blob NPP représentant la machine demandée. Ces objets BLOB NPP distants s’affichent dans la boîte de dialogue.

L’appelant doit appeler la fonction DestroyBlob , qui détruit l’objet BLOB retourné lorsqu’il n’est plus nécessaire.

Pour plus d’informations sur l’un des sujets suivants :	Consultez
Trois façons de sélectionner des cartes réseau	Sélection d’une carte d’interface réseau
Spécification d’un objet BLOB de filtre	Spécification d’un objet BLOB de filtre

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
Bibliothèque	Npptools.lib
DLL	Npptools.dll

Voir aussi

GetNPPBlobTable

SelectNPPBlobFromTable