Fungsi WTSOpenServerA (wtsapi32.h)

Membuka handel ke server Host Sesi Desktop Jarak Jauh (Host Sesi RD) yang ditentukan.

Sintaksis

HANDLE WTSOpenServerA(
  [in] LPSTR pServerName
);

Parameter

[in] pServerName

Penunjuk ke string yang dihentikan null yang menentukan nama NetBIOS dari server Host Sesi RD.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah handel ke server yang ditentukan.

Jika fungsi gagal, fungsi akan mengembalikan handel yang tidak valid. Anda dapat menguji validitas handel dengan menggunakannya dalam panggilan fungsi lain.

Komentar

Setelah Anda selesai menggunakan handel yang dikembalikan oleh WTSOpenServer, lepaskan dengan memanggil fungsi WTSCloseServer .

Anda tidak perlu membuka handel untuk operasi yang dilakukan pada server Host Sesi RD tempat aplikasi Anda berjalan. Gunakan konstanta _CURRENT_SERVER_HANDLE sebagai gantinya.

Nota

Header wtsapi32.h mendefinisikan WTSOpenServer sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	wtsapi32.h
Pustaka	Wtsapi32.lib
DLL	Wtsapi32.dll

Lihat juga

WTSCloseServer