Fungsi EvtOpenSession (winevt.h)

Artikel
03/13/2024

Membuat koneksi ke komputer jarak jauh yang bisa Anda gunakan saat memanggil fungsi Log Peristiwa Windows lainnya.

Sintaks

EVT_HANDLE EvtOpenSession(
  [in] EVT_LOGIN_CLASS LoginClass,
  [in] PVOID           Login,
  [in] DWORD           Timeout,
  [in] DWORD           Flags
);

Parameter

[in] LoginClass

Metode koneksi yang digunakan untuk menyambungkan ke komputer jarak jauh. Untuk nilai yang mungkin, lihat enumerasi EVT_LOGIN_CLASS .

[in] Login

Struktur EVT_RPC_LOGIN yang mengidentifikasi komputer jarak jauh yang ingin Anda sambungkan, kredensial pengguna, dan jenis autentikasi yang akan digunakan saat menyambungkan.

[in] Timeout

Dicadangkan. Harus nol.

[in] Flags

Dicadangkan. Harus nol.

Mengembalikan nilai

Jika berhasil, fungsi mengembalikan handel sesi yang dapat Anda gunakan untuk mengakses informasi log peristiwa di komputer jarak jauh; jika tidak, NULL. Jika NULL, panggil fungsi GetLastError untuk mendapatkan kode kesalahan.

Keterangan

Setelah Anda selesai dengan handel sesi, panggil fungsi EvtClose . Menutup handel sesi juga akan menutup semua handel terbuka yang dibuat dalam sesi (menutup handel terbuka membatalkan aktivitas saat ini pada handel tersebut).

Untuk tersambung ke komputer jarak jauh, komputer jarak jauh harus memfungsikan pengecualian Windows Log Management "Remote Event Log Management"; jika tidak, ketika Anda mencoba menggunakan handel sesi, panggilan akan bermasalah dengan RPC_S_SERVER_UNAVAILABLE. Komputer yang Anda sambungkan harus menjalankan Windows Vista atau yang lebih baru.

Fungsi ini tidak memvalidasi kredensial; kredensial divalidasi saat pertama kali Anda mencoba menggunakan handel sesi. Jika kredensial tidak valid, panggilan akan gagal dengan ERROR_ACCESS_DENIED.

Contoh

Untuk contoh yang memperlihatkan cara menggunakan fungsi ini, lihat Mengakses Komputer Jarak Jauh.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winevt.h
Pustaka	Wevtapi.lib
DLL	Wevtapi.dll

Lihat juga

EVT_LOGIN_CLASS

EvtClose

Bagikan melalui