Fungsi OpenNtmsSessionA (ntmsapi.h)

  • Artikel

[Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Fungsi OpenNtmsSession menyiapkan sesi dengan server RSM.

Sintaks

HANDLE OpenNtmsSessionA(
  [in] LPCSTR lpServer,
  [in] LPCSTR lpApplication,
       DWORD  dwOptions
);

Parameter

[in] lpServer

Nama server RSM. Jika parameter ini NULL, nama komputer saat ini akan digunakan.

[in] lpApplication

String karakter unik yang mengidentifikasi aplikasi. Nama ini mengidentifikasi sumber daya dan permintaan operator. Parameter ini bersifat opsional dan mungkin NULL.

dwOptions

Dipesan; harus nol.

Mengembalikan nilai

Jika OpenNtmsSession berhasil, openNtmsSession mengembalikan handel yang secara unik mengidentifikasi sesi ini. Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE. Untuk mengambil informasi selengkapnya, panggil fungsi GetLastError . Fungsi ini dapat mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_INVALID_COMPUTERNAME
 Format nama komputer yang ditentukan tidak dalam format yang valid.
ERROR_INVALID_PARAMETER
 Salah satu nilai parameter tidak valid.
ERROR_NO_NETWORK
 Jaringan tidak dimulai atau tidak tersedia.
ERROR_NOT_CONNECTED
 Tidak dapat tersambung ke layanan RSM.
ERROR_NOT_READY
 Layanan RSM belum dimulai. Aplikasi harus menunggu dan mencoba kembali.
ERROR_SUCCESS
 Fungsi berhasil.
INVALID_HANDLE_VALUE
 RSM tidak dapat membuka sesi.
RPC_S_NO_INTERFACES
 Layanan ini menggunakan versi RSM yang lebih lama daripada aplikasi Anda.

Keterangan

Fungsi OpenNtmsSession mengembalikan handel sesi yang digunakan dengan fungsi RSM lainnya, membuat koneksi dengan database RSM, dan menginisialisasi subsistem RSM untuk aplikasi.

Ketika OpenNtmsSession kembali, aplikasi dapat melakukan operasi RSM.

Sesi aman untuk utas tetapi tidak dapat diteruskan di antara proses.

Catatan

Header ntmsapi.h mendefinisikan OpenNtmsSession 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 XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntmsapi.h
Pustaka Ntmsapi.lib
DLL Ntmsapi.dll

Lihat juga

CloseNtmsSession

Fungsi Manajemen Sesi