Fungsi GetStringsFromBlob

Fungsi GetStringsFromBlob menggunakan panggilan berurutan untuk mengambil semua string dalam rentang yang ditentukan.

Sintaks

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]

Handel ke BLOB.

pRequestedOwnerName [in]

Penunjuk ke bagian Pemilik untuk mendapatkan string.

pRequestedCategoryName [in]

Penunjuk ke bagian Kategori untuk mendapatkan string.

pRequestedTagName [in]

Penunjuk ke tag untuk string yang diminta.

ppReturnedOwnerName [out]

Penunjuk ke variabel yang menunjuk ke tempat nama Pemilik akan dikembalikan.

ppReturnedCategoryName [out]

Penunjuk ke variabel yang menunjuk ke tempat nama Kategori akan dikembalikan.

ppReturnedTagName [out]

Penunjuk ke variabel yang menunjuk ke tempat nama Tag akan dikembalikan.

ppReturnedString [out]

Penunjuk ke variabel yang menunjuk ke tempat nama string akan dikembalikan.

pRestartKey [out]

Penunjuk ke variabel tempat kunci hidupkan ulang akan ditentukan dan dikembalikan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NMERR_SUCCESS.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah nilai NMERR yang menunjukkan masalah.

Jika kombinasi informasi Pemilik, Kategori, dan Tag yang ditentukan tidak ada, nilai yang dikembalikan NMERR_BLOB_ENTRY_DOES_NOT_EXIST.

Ketika BLOB dilalui sepenuhnya dalam batas yang awalnya ditentukan, fungsi mengembalikan NMERR_BLOB_ENTRY_DOES_NOT_EXIST, dan parameter pRestartKey menunjuk ke nol.

Keterangan

Pada panggilan awal ke fungsi GetStringsFromBlob , parameter pRestartKey menunjuk ke variabel yang berisi nilai nol. Parameter pRequested hanya dapat digunakan ketika kunci hidupkan ulang adalah nol. Dalam panggilan berikutnya, ketika pRestartKey memiliki nilai bukan nol, parameter pRequested diabaikan. Pada panggilan awal, semua dapat menunjuk ke NULL, yang menyiapkan kueri untuk mengembalikan setiap entri di BLOB, satu per panggilan berikutnya.

Menentukan pemilik membatasi string yang dikembalikan hanya ke pemilik tersebut. Batasan serupa berlaku untuk kategori dan tag, dengan peringatan tambahan bahwa jika kategori ditentukan, pemilik juga harus ditentukan dan jika tag ditentukan, kategori (dan oleh karena itu pemilik) harus ditentukan.

Ketika panggilan awal ke GetStringsFromBlob kembali, pRestartKey menunjuk ke nilai baru, yang harus ditentukan pada panggilan berikutnya ke fungsi untuk mendapatkan nilai berikutnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Netmon.h
Pustaka	Npptools.lib
DLL	Npptools.dll

Lihat juga

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob