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 [ dans]
-
Handle d’une fenêtre qui affiche la boîte de dialogue Sélectionner un réseau .
-
hFilterBlob [ dans]
-
Handle d’un objet blob de filtre utilisé pour limiter les cartes réseau affichées.
-
phBlob [ à]
-
Pointeur vers le handle de l’objet BLOB qui représente la carte réseau sélectionnée.
Valeur de retour
Si la fonction réussit (l’utilisateur sélectionne une carte réseau), la valeur de retour est NMERR _ Success et l’objet BLOB vers lequel pointe phBlob est renseigné.
Si l’utilisateur ne sélectionne pas une carte réseau, la valeur de retour est NMERR _ aucun _ NPP _ n’est sélectionné.
Si la fonction échoue, la valeur de retour est une autre valeur NMERR.
Notes
Quand elle est appelée, 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 renvoyé à l’application appelante.
Si l’objet BLOB nommé par hFilterBlob est un objet BLOB spécial, le Finder 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, le nom de l’ordinateur _ . Dans ce cas, le Finder transmet cet objet BLOB au NPP distant, qui retourne ensuite une table d’objets BLOB NPP représentant l’ordinateur demandé. 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 |
|