Fungsi WTSOpenServerExA (wtsapi32.h)

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

Sintaksis

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

Parameter

[in] pServerName

Penunjuk ke string null-terminated yang berisi nama NetBIOS server.

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

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 _CURRENT_SERVER_NAME untuk parameter pServerName .

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

Nota

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

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

Lihat juga

WTSCloseServer

WTSOpenServer