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 Abschnitt Besitzer, aus dem die Zeichenfolge abgerufen werden soll.
-
pRequestedCategoryName [in]
-
Ein Zeiger auf den Abschnitt Category, aus dem die Zeichenfolge abgerufen werden soll.
-
pRequestedTagName [in]
-
Ein Zeiger auf das Tag für die angeforderte Zeichenfolge.
-
ppReturnedOwnerName [out]
-
Ein Zeiger auf die Variable, der auf den Ort verweist, an den der Besitzername zurückgegeben wird.
-
ppReturnedCategoryName [out]
-
Ein Zeiger auf die Variable, der auf den Ort verweist, an den der Kategoriename zurückgegeben wird.
-
ppReturnedTagName [out]
-
Ein Zeiger auf die Variable, der auf den Ort verweist, an den der Tagname zurückgegeben wird.
-
ppReturnedString [out]
-
Ein Zeiger auf die Variable, der auf den Ort zeigt, an den der Zeichenfolgenname zurückgegeben wird.
-
pRestartKey [out]
-
Ein Zeiger auf die Variable, in der die Neustarttaste angegeben und zurückgegeben wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird 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, wird der Rückgabewert NMERR_BLOB_ENTRY_DOES_NOT_EXIST.
Wenn das BLOB vollständig innerhalb der ursprünglich angegebenen Grenzen durchlaufen wird, gibt die Funktion NMERR_BLOB_ENTRY_DOES_NOT_EXIST zurück, und der Parameter pRestartKey zeigt auf null.
Bemerkungen
Beim ersten Aufruf der GetStringsFromBlob-Funktion zeigt der Parameter pRestartKey auf eine Variable, die den Wert null enthält. Die Parameter pRequested können nur verwendet werden, wenn der Neustartschlüssel null ist. Wenn pRestartKey in nachfolgenden Aufrufen werte ungleich 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, einer pro nachfolgendem Aufruf.
Die Angabe eines Besitzers schränkt die Zeichenfolgen ein, die nur an diesen Besitzer zurückgegeben werden. Eine ähnliche Einschränkung gilt für Kategorien und Tags. Wenn eine Kategorie angegeben wird, muss auch ein Besitzer angegeben werden, und wenn ein Tag angegeben wird, muss eine Kategorie (und damit ein Besitzer) angegeben werden.
Wenn der anfängliche Aufruf von GetStringsFromBlob zurückgibt, verweist pRestartKey auf einen neuen Wert, der beim nächsten Aufruf der Funktion angegeben werden sollte, um den nächsten Wert abzurufen.
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 |
|