OpenNtmsSessionA 函式 （ntmsapi.h）

[ 從 Windows 7 和 Windows Server 2008 R2 起，卸除式存儲設備管理員 已無法使用。]

OpenNtmsSession 函式會設定與 RSM 伺服器的會話。

語法

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

參數

[in] lpServer

RSM 伺服器名稱。 如果此參數 NULL，則會使用目前的電腦名稱。

[in] lpApplication

識別應用程式的唯一字元字串。 此名稱會識別資源和操作員要求。 這個參數是選擇性的，而且可能會 NULL。

dwOptions

保留;必須是零。

傳回值

如果 OpenNtmsSession 成功，它會傳回可唯一識別此會話的句柄。 如果函式失敗，則會傳回INVALID_HANDLE_VALUE。 若要擷取詳細資訊，請呼叫 getLastError 函式 。 此函式可以傳回下列其中一個值。

價值	意義
ERROR_INVALID_COMPUTERNAME	指定的電腦名稱格式不是有效的格式。
ERROR_INVALID_PARAMETER	其中一個參數值無效。
ERROR_NO_NETWORK	網路未啟動或無法使用。
ERROR_NOT_CONNECTED	無法連線到 RSM 服務。
ERROR_NOT_READY	RSM 服務尚未啟動。 應用程式應該等候並重試。
ERROR_SUCCESS	函式成功。
INVALID_HANDLE_VALUE	RSM 無法開啟會話。
RPC_S_NO_INTERFACES	此服務所使用的 RSM 版本比您的應用程式還舊。

言論

OpenNtmsSession 函式會傳回與其他 RSM 函式搭配使用的會話句柄、建立與 RSM 資料庫的連線，以及初始化應用程式的 RSM 子系統。

當 OpenNtmsSession 傳回時，應用程式可以執行 RSM 作業。

會話是安全線程，但無法在進程之間傳遞。

注意

ntmsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 OpenNtmsSession 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ntmsapi.h
連結庫	Ntmsapi.lib
DLL	Ntmsapi.dll

另請參閱

CloseNtmsSession

工作階段管理功能