Fungsi SnmpCreateVbl (winsnmp.h)

Artikel
08/27/2023

[SNMP tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan Manajemen Jarak Jauh Windows, yang merupakan implementasi Microsoft dari WS-Man.]

Fungsi WinSNMP SnmpCreateVbl membuat daftar pengikatan variabel baru untuk aplikasi WinSNMP panggilan. Jika parameter nama dan nilai bukan NULL, SnmpCreateVbl menggunakan nilainya untuk membuat entri pengikatan variabel pertama untuk daftar pengikatan variabel baru. Fungsi SnmpCreateVbl mengembalikan handel ke daftar pengikatan variabel baru dan mengalokasikan memori yang diperlukan untuk itu.

Sintaks

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Parameter

[in] session

Tangani ke sesi WinSNMP.

[in] name

Penunjuk ke struktur smiOID yang berisi nama variabel untuk entri pengikatan variabel pertama. Parameter ini bisa NULL. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

[in] value

Pointer ke struktur smiVALUE yang berisi nilai untuk dikaitkan dengan variabel dalam entri pengikatan variabel pertama. Parameter ini bisa NULL. Untuk informasi tambahan, lihat bagian Keterangan berikut ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke daftar pengikatan variabel baru.

Jika fungsi gagal, nilai yang dikembalikan SNMPAPI_FAILURE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil SnmpGetLastError. Fungsi SnmpGetLastError dapat mengembalikan salah satu kesalahan berikut.

Menampilkan kode	Deskripsi
SNMPAPI_NOT_INITIALIZED	Fungsi SnmpStartup tidak berhasil diselesaikan.
SNMPAPI_ALLOC_ERROR	Terjadi kesalahan selama alokasi memori.
SNMPAPI_SESSION_INVALID	Handel sesi tidak valid.
SNMPAPI_OID_INVALID	Parameter nama mereferensikan struktur smiOID yang tidak valid.
SNMPAPI_SYNTAX_INVALID	Anggota sintaks struktur yang ditujukkan oleh parameter nilai tidak valid.
SNMPAPI_OTHER_ERROR	Terjadi kesalahan yang tidak diketahui atau tidak terdefinis.

Keterangan

Fungsi SnmpCreateVbl menggunakan nilai parameter nama dan nilai untuk membuat dan menginisialisasi entri pengikatan variabel pertama dari daftar pengikatan variabel baru. Jika parameter namaNULL, implementasi Microsoft WinSNMP mengabaikan parameter nilai dan membuat daftar pengikatan variabel kosong.

Jika parameter nama bukan NULL, tetapi parameter nilai adalah NULL, implementasi membuat dan menginisialisasi entri pengikatan variabel pertama dalam daftar pengikatan variabel. Ini menginisialisasi anggota sintaks struktur yang ditujukkan oleh parameter nilai dengan nilai SNMP_SYNTAX_NULL.

Aplikasi WinSNMP harus merilis sumber daya yang terkait dengan setiap daftar pengikatan variabel. Ini harus dilakukan dengan mencocokkan setiap panggilan ke fungsi SnmpCreateVbl dan SnmpDuplicateVbl dengan panggilan yang sesuai ke fungsi SnmpFreeVbl . Untuk menghindari kebocoran memori, aplikasi WinSNMP harus memanggil SnmpFreeVbl sebelum menggunakan kembali handel ke daftar pengikatan variabel dalam panggilan berikutnya ke SnmpCreateVbl atau SnmpDuplicateVbl. Untuk informasi tambahan, lihat Konsep Manajemen Data WinSNMP.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winsnmp.h
Pustaka	Wsnmp32.lib
DLL	Wsnmp32.dll