Metode IStats::Connect

Metode Connect menghubungkan NPP ke jaringan dengan menggunakan NIC tertentu dan menyediakan informasi konfigurasi untuk koneksi.

Sintaks

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Parameter

hInputBlob [in]

Tangani ke BLOB yang menentukan NIC yang disambungkan NPP dan informasi konfigurasi untuk koneksi tersebut.

StatusCallbackProc [in]

Alamat fungsi panggilan balik pengguna, yang menerima pembaruan status seperti pemicu. Jika fungsi panggilan balik tidak digunakan, atur parameter ini dan parameter UserContext ke NULL.

UserContext [in]

Nilai diteruskan saat fungsi panggilan balik pengguna dipanggil. Nilai parameter ini biasanya HWND atau penunjuk 'ini'. Jika fungsi panggilan balik tidak ditentukan, atur parameter ini dan parameter StatusCallbackProc ke NULL.

hErrorBlob [out]

Menangani blob kesalahan yang berisi informasi kesalahan tambahan.

Mengembalikan nilai

Jika metode berhasil, nilai yang dikembalikan NMERR_SUCCESS.

Jika metode tidak berhasil, nilai yang dikembalikan adalah salah satu kode kesalahan berikut (yang mencakup kesalahan yang dikembalikan oleh IStats internal::Konfigurasikan panggilan):

Menampilkan kode Deskripsi
NMERR_ALREADY_CONNECTED
Instans objek NPP COM ini sudah tersambung ke jaringan.
NMERR_BLOB_CONVERSION_ERROR
BLOB konfigurasi rusak. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
BLOB input yang ditentukan oleh parameter hInputBlob tidak memiliki entri yang diperlukan untuk melakukan operasi ini. Kesalahan ini mungkin dihasilkan oleh panggilan IStats::Connect atau IStats::Configure . Lihatlah kesalahan BLOB yang dikembalikan oleh hErrorBlob untuk menentukan entri mana yang tidak ditemukan.
NMERR_BLOB_NOT_INITIALIZED
Fungsi CreateBlob belum dipanggil. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_BLOB_STRING_INVALID
String tidak dihentikan null. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_ILLEGAL_TRIGGER
Bagian pemicu blob input rusak. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_INVALID_BLOB
Objek yang ditentukan dalam hInputBlob bukan BLOB. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
Direktori pengambilan default tidak diatur dalam registri. Untuk mengatur direktori pengambilan, gunakan jalur berikut.
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY
Memori yang diperlukan untuk melakukan operasi ini tidak tersedia. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_TIMEOUT
Waktu permintaan habis. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .
NMERR_UPLEVEL_BLOB
Nomor versi BLOB yang ditentukan dalam hInputBlob salah. Kesalahan ini dihasilkan oleh panggilan IStats::Configure .

Keterangan

Ketika metode Connect dipanggil, Network Monitor secara otomatis memanggil metode IStats::Configure dengan menggunakan BLOB yang disediakan oleh parameter hInputBlob . Perhatikan bahwa setiap kode kesalahan yang dikembalikan oleh panggilan ke IStats::Configure diteruskan kembali dan dikembalikan oleh panggilan IStats::Connect .

Metode ini harus dipanggil sebelum Anda dapat mulai menangkap bingkai. Perhatikan bahwa ketika Anda terhubung ke jaringan dengan menggunakan metode ini, Anda harus terus menggunakan antarmuka IStats untuk mengambil bingkai.

BLOB input yang ditentukan oleh hInputBlob dapat diperoleh dengan memanggil metode GetNPPBlobFromUI, GetNPPBlobTable, dan SelectNPPBlobFromTable .

BLOB kesalahan yang dikembalikan oleh parameter hErrorBlob berisi entri yang tidak dapat dipahami atau ditemukan oleh Monitor Jaringan dalam BLOB input yang ditentukan dalam hInputBlob. BLOB kesalahan yang dikembalikan berisi informasi kesalahan yang dapat digunakan aplikasi untuk pemecahan masalah. Misalnya, jika NMERR_BLOB_ENTRY_DOES_NOT_EXIST dikembalikan, entri yang tidak dapat ditemukan Monitor Jaringan disertakan dalam BLOB kesalahan yang dikembalikan.

Untuk informasi tentang Lihat
Mendapatkan BLOB input yang mewakili kartu antarmuka jaringan Memilih Kartu Antarmuka Jaringan

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
DLL
Ndisnpp.dll;
Rmtnpp.dll

Lihat juga

IStats

IStats::Configure

IStats::D sambungkan

BLOB Monitor Jaringan