Fungsi WTSOpenServerExA (wtsapi32.h)

  • Artikel

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

Sintaks

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

Parameter

[in] pServerName

Penunjuk ke string yang dihentikan null yang berisi nama NetBIOS server.

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

Jika server yang ditentukan oleh parameter pServerName adalah server Host Sesi RD, perilaku fungsi ini identik dengan fungsi WTSOpenServer .

Untuk bekerja dengan sesi yang berjalan pada komputer virtual di server Host Virtualisasi RD tempat aplikasi panggilan berjalan, tentukan WTS_CURRENT_SERVER_NAME untuk parameter pServerName .

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

Catatan

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

Lihat juga

WTSCloseServer

WTSOpenServer