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 标头将 OpenNtmsSession 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	ntmsapi.h
Library	Ntmsapi.lib
DLL	Ntmsapi.dll

另请参阅

CloseNtmsSession

会话管理功能