Función SetNtmsUIOptionsA (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 SetNtmsUIOptions modifica la lista de nombres de equipo a los que se dirige el tipo de interfaz de usuario especificado para el objeto especificado.

Sintaxis

DWORD SetNtmsUIOptionsA(
  [in]  HANDLE            hSession,
  [in]  const LPNTMS_GUID lpObjectId,
  [in]  DWORD             dwType,
  [in]  DWORD             dwOperation,
  [out] LPCSTR            lpszDestination
);

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpObjectId

Identificador único del objeto cuya interfaz de usuario se redirige. El objeto debe ser un contenedor que pueda ser un origen para los eventos. El objeto puede ser una aplicación (una solicitud de montaje desencadenada por la aplicación), una biblioteca (una solicitud abierta de puerta en respuesta a una expulsión) o un equipo (toda la interfaz de usuario que pertenece al equipo).

Para especificar el contenedor del equipo, establezca el puntero lpObjectId para que apunte a un búfer con el GUID del objeto de equipo del Administrador de almacenamiento extraíble. Para especificar una biblioteca determinada, establézcala para que apunte a un búfer con el GUID de la biblioteca. Para especificar una aplicación, pase un puntero NULL . La identidad de la aplicación viene determinada por la sesión usada en hSession. Tenga en cuenta que una aplicación puede tener varias sesiones abiertas simultáneamente. En este caso, el conjunto de valores solo se aplica a la sesión hSession . En el caso de una biblioteca o instancia de equipo, la configuración persiste hasta que se cambia explícitamente. Las filas de la aplicación se eliminan cuando se cierra la sesión.

[in] dwType

Este parámetro puede tener uno de los valores siguientes.

Valor Significado
NTMS_UITYPE_INFO
 Mensajes de la interfaz de usuario que proporcionan información. Estos incluyen los elementos de la cola de trabajo que indican el progreso. Por ejemplo, monte las solicitudes.
NTMS_UITYPE_REQ
 Mensajes de la interfaz de usuario que son solicitudes. Entre ellas se incluyen las solicitudes de operador que controlan los medios. Por ejemplo, una solicitud para insertar nuevos medios.
NTMS_UITYPE_ERR
 Mensajes de la interfaz de usuario que proporcionan información de error. Entre ellas se incluyen las solicitudes de operador relacionadas con la notificación de errores. Por ejemplo, una solicitud para limpiar la unidad.

[in] dwOperation

Este parámetro puede tener uno de los valores siguientes.

Valor Significado
NTMS_UIDEST_ADD
 Agregue un nuevo destino (nombre de equipo) a la lista.
NTMS_UIDEST_DELETE
 Quite un destino de la lista.
NTMS_UIDEST_DELETEALL
 Borre todos los destinos de la lista. No se genera ninguna interfaz de usuario para el objeto. En este caso, se omite el argumento de destino.

[out] lpszDestination

Cadena múltiple que devuelve los nombres de los equipos a los que se redirige la interfaz de usuario. Este parámetro no puede ser NULL.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Se deniega el acceso a uno o varios objetos RSM.
ERROR_ALREADY_EXISTS
 El destino especificado ya existe en la lista.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 el puntero lpdwSize o lpszDestination es NULL, o lpObjectId no es un contenedor válido, o dwType o dwOperation no es uno de los tres valores válidos.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_OBJECT_NOT_FOUND
 El GUID especificado por lpObjectId no es el GUID de ningún objeto de equipo o biblioteca en la base de datos.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Una llamada a SetNtmsUIOptions agrega o quita un destino para una instancia determinada determinada por los parámetros lpObjectId y dwType .

  NTMS_UITYPE_INFO NTMS_UITYPE_REQ NTMS_UITYPE_ERR
Application Muestra la interfaz de usuario de progreso del elemento de trabajo para los elementos de trabajo generados por esta aplicación. Muestra la interfaz de usuario de solicitud del operador para las solicitudes de operador generadas por las acciones realizadas por esta aplicación. Sin definir. Las aplicaciones no pueden provocar este tipo de evento de error.
Biblioteca Muestra la interfaz de usuario de progreso del elemento de trabajo para los elementos de trabajo asociados a esta biblioteca. Muestra la interfaz de usuario de las solicitudes asociadas a esta biblioteca. Muestra la interfaz de usuario de los errores asociados a esta biblioteca.
Computer Mostrar la interfaz de usuario informativa en esta instancia de RSM que se ejecuta en esta máquina. Muestra una interfaz de usuario de tipo de solicitud en esta instancia de RSM. Muestra la interfaz de usuario de tipo de error en esta instancia de RSM.
 

Tenga en cuenta que las comprobaciones de seguridad se realizan al llamar a SetNtmsUIOptions. Cuando se especifica el objeto de equipo, debe tener acceso con permiso para modificar el equipo. Al modificar el elemento de interfaz de usuario de una biblioteca, debe tener acceso con permiso para modificar el objeto de biblioteca.

Tenga en cuenta que no hay ninguna comprobación de las cadenas de destino. Una llamada a con un nombre de destino al que no se puede acceder desde el equipo en el que se llama SetNtmsUIOptions devuelve éxito. Se toma un puntero a una cadena vacía para significar el equipo local.

Nota

El encabezado ntmsapi.h define SetNtmsUIOptions 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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

GetNtmsUIOptions

Funciones de control de biblioteca