Fungsi WTSEnumerateProcessesA (wtsapi32.h)

Mengambil informasi tentang proses aktif pada server Host Sesi Desktop Jarak Jauh (Host Sesi RD) tertentu.

Sintaks

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

Parameter

[in] hServer

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

[in] Reserved

Dipesan; harus nol.

[in] Version

Menentukan versi permintaan enumerasi. Harus 1.

[out] ppProcessInfo

Penunjuk ke variabel yang menerima penunjuk ke array struktur WTS_PROCESS_INFO . Setiap struktur dalam array berisi informasi tentang proses aktif pada server Host Sesi RD yang ditentukan. Untuk membebaskan buffer yang dikembalikan, panggil fungsi WTSFreeMemory .

[out] pCount

Pointer ke variabel yang menerima jumlah struktur WTS_PROCESS_INFO yang dikembalikan dalam buffer 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, hubungi GetLastError.

Keterangan

Pemanggil harus menjadi anggota grup Administrator untuk menghitung proses yang berjalan di bawah konteks pengguna yang berbeda.

Catatan

Header wtsapi32.h mendefinisikan WTSEnumerateProcesses 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 Vista
Server minimum yang didukung	Windows Server 2008
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

WTS_PROCESS_INFO