Fungsi WTSEnumerateProcessesExA (wtsapi32.h)

  • Artikel

Mengambil informasi tentang proses aktif pada server Host Sesi Desktop Jarak Jauh (Host Sesi RD) yang ditentukan atau server Host Virtualisasi Desktop Jarak Jauh (Host Virtualisasi RD).

Sintaks

BOOL WTSEnumerateProcessesExA(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPSTR  *ppProcessInfo,
  [out]     DWORD  *pCount
);

Parameter

[in] hServer

Handel ke server Host Sesi RD. Tentukan handel yang dibuka oleh fungsi WTSOpenServer , atau tentukan WTS_CURRENT_SERVER_HANDLE untuk menunjukkan server tempat aplikasi Anda berjalan.

[in, out] pLevel

Penunjuk ke variabel DWORD yang, pada input, menentukan jenis informasi yang akan dikembalikan. Untuk mengembalikan array struktur WTS_PROCESS_INFO , tentukan nol. Untuk mengembalikan array struktur WTS_PROCESS_INFO_EX , tentukan satu.

Jika Anda tidak menentukan nilai yang valid untuk parameter ini, pada output, WTSEnumerateProcessesEx mengatur parameter ini ke satu dan mengembalikan kesalahan. Jika tidak, pada output, WTSEnumerateProcessesEx tidak mengubah nilai parameter ini.

[in] SessionId

Sesi untuk menghitung proses. Untuk menghitung proses untuk semua sesi di server, tentukan WTS_ANY_SESSION.

[out] ppProcessInfo

Penunjuk ke variabel yang menerima penunjuk ke array struktur WTS_PROCESS_INFO atau WTS_PROCESS_INFO_EX . Jenis struktur ditentukan oleh nilai yang diteruskan ke parameter pLevel . Setiap struktur dalam array berisi informasi tentang proses aktif. Setelah Anda selesai menggunakan array , bebaskan dengan memanggil fungsi WTSFreeMemoryEx . Anda juga harus mengatur penunjuk ke NULL.

[out] pCount

Penunjuk ke variabel yang menerima jumlah
struktur yang dikembalikan dalam buffer yang direferensikan oleh parameter ppProcessInfo .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Penelepon harus menjadi anggota grup Administrator untuk menghitung proses yang berjalan di bawah sesi pengguna lain.

Catatan

Header wtsapi32.h mendefinisikan WTSEnumerateProcessesEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Server minimum yang didukung Windows Server 2008 R2
Target Platform Windows
Header wtsapi32.h
Pustaka Wtsapi32.lib
DLL Wtsapi32.dll
Set API ext-ms-win-session-wtsapi32-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

WTSBuka Server

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX