Metode IMofCompiler::CompileBuffer (wbemcli.h)

Metode IMofCompiler::CompileBuffer mengkompilasi buffer yang berisi data MOF biner atau buffer teks dalam format ASCII. File MOF biner berisi data yang diurai dan harus disimpan dalam database. Metode CompileBuffer hanya menerima array karakter multi-byte (buffer string) yang tidak dihentikan NULL.

Sintaks

HRESULT CompileBuffer(
  [in]      long                     BuffSize,
  [in]      BYTE                     *pBuffer,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LPWSTR                   User,
  [in]      LPWSTR                   Authority,
  [in]      LPWSTR                   Password,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

Parameter

[in] BuffSize

Ukuran data yang diacu oleh parameter pBuffer .

[in] pBuffer

Arahkan ke data file MOF biner atau buffer teks dalam format ASCII.

[in] ServerAndNamespace

Nama server dan namespace layanan.

Parameter ini diabaikan kecuali parameter pBuffer menunjuk ke buffer teks. Jika TEKS MOF diteruskan tanpa pernyataan #pragma , maka file MOF dikompilasi ke dalam namespace default. Jika pBuffer menunjuk ke file MOF biner, parameter ServerAndNamespace harus NULL.

[in] User

Nama pengguna yang meminta layanan.

Parameter ini menentukan kredensial untuk dikompilasi pada komputer jarak jauh. Jika nilainya NULL, maka konteks pengguna adalah apa pun yang digunakan proses saat ini. Ini selalu diabaikan ketika menyambungkan ke komputer lokal. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] Authority

Menentukan kredensial untuk dikompilasi pada komputer jarak jauh. Jika nilainya ADALAH NULL, konteks otoritas adalah apa pun yang digunakan proses saat ini. Parameter ini selalu diabaikan saat menyambungkan ke komputer lokal. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] Password

Menentukan kredensial untuk dikompilasi pada komputer jarak jauh. Jika nilainya ADALAH NULL, kata sandi konteks saat ini digunakan. Parameter ini selalu diabaikan saat menyambungkan ke komputer lokal.

[in] lOptionFlags

Anda dapat menggabungkan satu atau beberapa bendera berikut.

WBEM_FLAG_CHECK_ONLY

Hanya melakukan pemeriksaan sintaks.

WBEM_FLAG_AUTORECOVER

Jika metode berhasil, metode menambahkan nama file ke daftar file yang akan dikompilasi selama pemulihan database otomatis.

Bendera ini tidak dapat digabungkan dengan namespace, kelas, atau bendera instans.

WBEM_FLAG_CONSOLE_PRINT

Mengirim berbagai pesan berguna ke konsol.

WBEM_FLAG_DONT_ADD_TO_LIST

Mencegah penambahan file ke daftar file yang akan dikompilasi selama pemulihan database otomatis.

Bendera ini tidak kompatibel dengan WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Parameter ini diabaikan karena file MOF biner sudah berisi informasi. Nilai parameter harus 0.

[in] lInstanceFlags

Diabaikan karena file MOF biner sudah berisi informasi. Nilai parameter harus 0.

[in, out] pInfo

Penunjuk ke WBEM_COMPILE_STATUS_INFO yang menjelaskan kesalahan.

Jika nilai parameter bukan NULL, kesalahan telah terjadi, dan struktur diisi dengan informasi kesalahan.

Nilai kembali

Metode ini mengembalikan WBEM_S_NO_ERROR jika berhasil. Jika metode tidak berhasil, metode akan mengembalikan WBEM_S_FALSE.

Keterangan

Jika parameter Pengguna mengambil domain formulir <\pengguna>, parameter Otoritas harus NULL.

Data MOF biner dapat dihasilkan oleh metode CreateBMOF , yang menyimpan data MOF biner ke dalam file yang dapat dibaca sebelum memanggil metode CompileBuffer .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Mofd.dll

Lihat juga

IMofCompiler

WBEM_COMPILER_OPTIONS