Fungsi WTSOpenServerA (wtsapi32.h)

  • Artikel

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

Sintaks

HANDLE WTSOpenServerA(
  [in] LPSTR pServerName
);

Parameter

[in] pServerName

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

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan 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.

Keterangan

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 WTS_CURRENT_SERVER_HANDLE konstanta sebagai gantinya.

Catatan

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

Lihat juga

WTSCloseServer