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	Netmon.h
Bibliothek	Npptools.lib
DLL	Npptools.dll

Weitere Informationen

GetNPPBlobTable

SelectNPPBlobFromTable