Función OpenNtmsSessionW (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función OpenNtmsSession configura una sesión con un servidor RSM.

Sintaxis

HANDLE OpenNtmsSessionW(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpApplication,
       DWORD   dwOptions
);

Parámetros

[in] lpServer

Nombre del servidor RSM. Si este parámetro es NULL, se usa el nombre de equipo actual.

[in] lpApplication

Cadena de caracteres única que identifica la aplicación. Este nombre identifica los recursos y las solicitudes de operador. Este parámetro es opcional y puede ser NULL.

dwOptions

Reservados; debe ser cero.

Valor devuelto

Si OpenNtmsSession se realiza correctamente, devuelve un identificador que identifica de forma única esta sesión. Si se produce un error en la función, devuelve INVALID_HANDLE_VALUE. Para recuperar más información, llame a la función GetLastError . Esta función puede devolver uno de los siguientes valores.

Valor Significado
ERROR_INVALID_COMPUTERNAME
 El formato de nombre de equipo que se especificó no tenía un formato válido.
ERROR_INVALID_PARAMETER
 Uno de los valores de parámetro no era válido.
ERROR_NO_NETWORK
 La red no se inicia o no está disponible.
ERROR_NOT_CONNECTED
 No se puede conectar al servicio RSM.
ERROR_NOT_READY
 El servicio RSM no se ha iniciado. La aplicación debe esperar y reintentar.
ERROR_SUCCESS
 La función se realizó correctamente.
INVALID_HANDLE_VALUE
 RSM no puede abrir una sesión.
RPC_S_NO_INTERFACES
 El servicio usa una versión anterior de RSM que la aplicación.

Comentarios

La función OpenNtmsSession devuelve un identificador de sesión usado con otras funciones de RSM, establece una conexión con la base de datos RSM e inicializa el subsistema RSM para la aplicación.

Cuando Se devuelve OpenNtmsSession , la aplicación puede realizar operaciones de RSM.

Las sesiones son seguras para subprocesos, pero no se pueden pasar entre procesos.

Nota

El encabezado ntmsapi.h define OpenNtmsSession como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

CloseNtmsSession

Funciones de administración de sesiones