GetNPPBlobTable-Funktion

Artikel
06/13/2023

Die GetNPPBlobTable-Funktion ruft eine NPP-BLOB-Tabelle ab, die die Register-NICs auf dem lokalen Computer darstellt.

Syntax

DWORD GetNPPBlobTable(
  _In_  HBLOB       hFilterBlob,
  _Out_ PBLOB_TABLE *ppBlobTable
);

Parameter

hFilterBlob [in]: Handle für ein Filterblob, das die in der Tabelle zurückgegebenen NPP-BLOBs einschränkt.
ppBlobTable [out]: Zeiger auf eine BLOB_TABLE-Struktur , die mindestens einen BLOB-Zeiger enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes:

Rückgabecode	Beschreibung
NMERR_NO_NPP_DLL	Im NPP-Verzeichnis wurden keine DLLs gefunden.
NMERR_NO_VALID_NPP_DLLS	Keine der DLLs im NPP-Verzeichnis waren gültige NPP-DLLs.
NMERR_NO_MATCHING_NPPS	NPP-BLOBs wurden ermittelt, aber keiner hat den Filtertest bestanden.
NMERR_OUT_OF_MEMOR	Der Netzwerkmonitor konnte keinen Arbeitsspeicher zuweisen.

Bemerkungen

Das von hFilterBlob benannte BLOB kann auch ein spezielles BLOB sein.

Wenn Sie das Flag im Filter BLOB auf TRUE festlegen, kann die zurückgegebene BLOB-Tabelle auch spezielle BLOBs enthalten.

Wenn das von hFilterBlob benannte BLOB ein spezielles BLOB ist, versucht die Benutzeroberfläche des Netzwerkmonitors, es zu verarbeiten. Angenommen, ein vorheriger Aufruf gibt ein spezielles BLOB vom Remote-NPP zurück. Die Anwendung fügt das erforderliche Tag MACHINE_NAME ein. Der Finder übergibt dieses BLOB dann an das Remote-NPP, das dann eine Tabelle der NPP-BLOBs zurückgibt, die dem Computernamen zugeordnet sind.

Um alle zurückgegebenen BLOBs und die BLOB-Tabelle zu zerstören, ist der Aufrufer für den Aufruf der DestroyBlob-Funktion verantwortlich.

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