GetStringsFromBlob-Funktion

Die GetStringsFromBlob-Funktion verwendet sequenzielle Aufrufe, um alle Zeichenfolgen innerhalb der angegebenen Bereiche abzurufen.

Syntax

DWORD GetStringsFromBlob(
  _In_        HBLOB hBlob,
  _In_  const char  *pRequestedOwnerName,
  _In_  const char  *pRequestedCategoryName,
  _In_  const char  *pRequestedTagName,
  _Out_ const char  **ppReturnedOwnerName,
  _Out_ const char  **ppReturnedCategoryName,
  _Out_ const char  **ppReturnedTagName,
  _Out_ const char  **ppReturnedString,
  _Out_       DWORD *pRestartKey
);

Parameter

hBlob [ In]

Ein Handle für das BLOB.

pRequestedOwnerName [ In]

Ein Zeiger auf den Owner-Abschnitt, aus dem die Zeichenfolge abzurufen ist.

pRequestedCategoryName [ In]

Ein Zeiger auf den Abschnitt Category, aus dem die Zeichenfolge abzurufen ist.

pRequestedTagName [ In]

Ein Zeiger auf das -Tag für die angeforderte Zeichenfolge.

ppReturnedOwnerName [ out]

Ein Zeiger auf die Variable, die auf den Ort zeigt, an dem der Besitzername zurückgegeben wird.

ppReturnedCategoryName [ out]

Ein Zeiger auf die Variable, die auf den Ort zeigt, an dem der Kategoriename zurückgegeben wird.

ppReturnedTagName [ out]

Ein Zeiger auf die Variable, die auf den Ort zeigt, an dem der Tagname zurückgegeben wird.

ppReturnedString [ out]

Ein Zeiger auf die Variable, die auf den Rückgabeort des Zeichenfolgennamens zeigt.

pRestartKey [ out]

Ein Zeiger auf die Variable, in der der Neustartschlüssel angegeben und zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet der Rückgabewert NMERR _ SUCCESS.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein NMERR-Wert, der das Problem angibt.

Wenn keine angegebene Kombination aus Besitzer-, Kategorie- und Taginformationen vorhanden ist, lautet der Rückgabewert NMERR _ BLOB ENTRY DOES NOT _ _ _ _ EXIST.

Wenn das BLOB vollständig innerhalb der anfänglich angegebenen Grenzen durchlaufen wird, gibt die Funktion NMERR _ BLOB ENTRY DOES NOT _ _ _ _ EXIST zurück, und der pRestartKey-Parameter zeigt auf 0 (null).

Bemerkungen

Beim ersten Aufruf der GetStringsFromBlob-Funktion zeigt der pRestartKey-Parameter auf eine Variable, die den Wert 0 (null) enthält. Die pRequested-Parameter können nur verwendet werden, wenn der Neustartschlüssel 0 (null) ist. Wenn pRestartKey in nachfolgenden Aufrufen Werte ungleich 0 (null) aufweist, werden die pRequested-Parameter ignoriert. Beim ersten Aufruf können alle auf NULL verweisen, wodurch die Abfrage so eingerichtet wird, dass jeder Eintrag im BLOB zurückgegeben wird ( ein Eintrag pro nachfolgendem Aufruf).

Wenn Sie einen Besitzer angeben, werden die zurückgegebenen Zeichenfolgen auf diesen Besitzer beschränkt. Eine ähnliche Einschränkung gilt für Kategorien und Tags, mit dem zusätzlichen Nachteil, dass, wenn eine Kategorie angegeben wird, auch ein Besitzer angegeben werden muss und wenn ein Tag angegeben wird, eine Kategorie (und somit ein Besitzer) angegeben werden muss.

Wenn der erste Aufruf von GetStringsFromBlob zurückgegeben wird, zeigt pRestartKey auf einen neuen Wert, der beim nächsten Aufruf der Funktion angegeben werden sollte, um den nächsten Wert abzurufen.

Requirements (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

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob