GetNPPBlobFromUI-Funktion
Die GetNPPBlobFromUI-Funktion wählt eine Register-NIC aus.
Syntax
DWORD GetNPPBlobFromUI(
_In_ HWND hwnd,
_In_ HBLOB hFilterBlob,
_Out_ HBLOB *phBlob
);
Parameter
-
hwnd [in]
-
Ein Handle für ein Fenster, in dem das Dialogfeld Netzwerk auswählen angezeigt wird.
-
hFilterBlob [in]
-
Ein Handle für ein Filterblob , das verwendet wird, um zu begrenzen, welche NICs angezeigt werden.
-
phBlob [out]
-
Ein Zeiger auf das Handle des BLOB, das die ausgewählte NIC darstellt.
Rückgabewert
Wenn die Funktion erfolgreich ist (der Benutzer wählt eine NIC aus), lautet der Rückgabewert NMERR_SUCCESS, und das BLOB, auf das phBlob zeigt, wird ausgefüllt.
Wenn der Benutzer keine NIC auswählt, wird der Rückgabewert NMERR_NO_NPP_SELECTED.
Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein weiterer NMERR-Wert.
Bemerkungen
Wenn der Netzwerkmonitor aufgerufen wird, wird das Dialogfeld Netzwerk auswählen angezeigt, mit dem Sie eine Netzwerkkarte auswählen können. Das NPP-BLOB, das die NIC darstellt, wird an die aufrufende Anwendung zurückgegeben.
Wenn das von hFilterBlob benannte BLOB ein spezielles BLOB ist, versucht der Finder, es zu verarbeiten. Ein Beispiel hierfür wäre ein Aufruf, der zuvor ein spezielles BLOB vom Remote-Netzwerkdienst zurückgegeben hatte. Die Anwendung hat das erforderliche Tag MACHINE_NAME eingefügt. In diesem Fall übergibt der Finder dieses BLOB an das Remote-NPP, das dann eine Tabelle mit NPP-BLOBs zurückgibt, die den angeforderten Computer darstellen. Diese Remote-NPP-BLOBs werden im Dialogfeld angezeigt.
Der Aufrufer muss die DestroyBlob-Funktion aufrufen, die das zurückgegebene BLOB zerstört, wenn es nicht mehr benötigt wird.
| Weitere Informationen über | Siehe |
|---|---|
| Drei Möglichkeiten zum Auswählen von NICs | Auswählen einer Netzwerkschnittstellenkarte |
| Angeben eines Filterblobs | Angeben eines Filterblobs |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|