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 函数。此函数可以返回以下值之一。

OpenNtmsSession 函数返回与其他 RSM 函数一起使用的会话句柄，与 RSM 数据库建立连接，并为应用程序初始化 RSM 子系统。

OpenNtmsSession 返回时，应用程序可以执行 RSM 操作。

会话是线程安全的，但不能在进程之间传递。

注意

ntmsapi.h 标头将 OpenNtmsSession 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。