OpenNtmsSessionW 函式 (ntmsapi.h)
[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員 。]
OpenNtmsSession 函式會設定與 RSM 伺服器的會話。
語法
HANDLE OpenNtmsSessionW(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpApplication,
DWORD dwOptions
);
參數
[in] lpServer
RSM 伺服器名稱。 如果此參數為 NULL，則會使用目前的電腦名稱。
[in] lpApplication
識別應用程式的唯一字元字串。 此名稱會識別資源和操作員要求。 這個參數是選擇性的，而且可以是 NULL。
dwOptions
保留;必須是零。
傳回值
如果 OpenNtmsSession 成功，它會傳回可唯一識別此會話的句柄。 如果函式失敗，它會傳回INVALID_HANDLE_VALUE。 若要擷取詳細資訊，請呼叫 GetLastError 函 式。 此函式可以傳回下列其中一個值。
| 值 | 意義 |
|---|---|
|
指定的電腦名稱格式不是有效的格式。 |
|
其中一個參數值無效。 |
|
網路未啟動或無法使用。 |
|
無法連線到 RSM 服務。 |
|
RSM 服務尚未啟動。 應用程式應該等候並重試。 |
|
函式成功。 |
|
RSM 無法開啟會話。 |
|
此服務使用的 RSM 版本比您的應用程式舊版。 |
備註
OpenNtmsSession 函式會傳回與其他 RSM 函式搭配使用的會話句柄、建立與 RSM 資料庫的連線，以及初始化應用程式的 RSM 子系統。
當 OpenNtmsSession 傳回時，應用程式可以執行 RSM 作業。
會話是安全線程，但無法在進程之間傳遞。
注意
ntmsapi.h 標頭會將 OpenNtmsSession 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ntmsapi.h |
| 程式庫 | Ntmsapi.lib |
| Dll | Ntmsapi.dll |