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 |
---|---|
|
Instans objek NPP COM ini sudah tersambung ke jaringan. |
|
BLOB konfigurasi rusak. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
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. |
|
Fungsi CreateBlob belum dipanggil. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
String tidak dihentikan null. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
Bagian pemicu blob input rusak. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
Objek yang ditentukan dalam hInputBlob bukan BLOB. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
Direktori pengambilan default tidak diatur dalam registri. Untuk mengatur direktori pengambilan, gunakan jalur berikut.
|
|
Memori yang diperlukan untuk melakukan operasi ini tidak tersedia. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
Waktu permintaan habis. Kesalahan ini dihasilkan oleh panggilan IStats::Configure . |
|
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 |
|
DLL |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk