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 |
|
| Bibliothèque |
|
| DLL |
|