Compartir a través de


Función SetNtmsUIOptionsA (ntmsapi.h)

[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 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 un eject) o un equipo (toda la interfaz de usuario que pertenece al equipo).

Para especificar el contenedor de equipos, establezca el lpObjectId puntero 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 de de hSession. En el caso de una biblioteca o instancia de equipo, la configuración se conserva 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 siguientes valores.

Valor Significado
NTMS_UITYPE_INFO
Mensajes de interfaz de usuario que proporcionan información. Estos incluyen los elementos de cola de trabajo que indican el progreso. Por ejemplo, monte las solicitudes.
NTMS_UITYPE_REQ
Mensajes de 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 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 siguientes valores.

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 siguientes valores.

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
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.

Observaciones

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

  NTMS_UITYPE_INFO NTMS_UITYPE_REQ NTMS_UITYPE_ERR
Aplicación Mostrar 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 de operador para las solicitudes de operador generadas por las acciones realizadas por esta aplicación. Indefinido. Las aplicaciones no pueden provocar este tipo de evento de error.
Biblioteca Mostrar la interfaz de usuario de progreso del elemento de trabajo para los elementos de trabajo asociados a esta biblioteca. Mostrar la interfaz de usuario de las solicitudes asociadas a esta biblioteca. Mostrar la interfaz de usuario de los errores asociados a esta biblioteca.
Ordenador 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. Mostrar 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 que no es un equipo accesible desde el equipo en el que SetNtmsUIOptions llama devuelve correctamente. Se toma un puntero a una cadena vacía para significar la máquina 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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de ntmsapi.h
biblioteca de Ntmsapi.lib
DLL de Ntmsapi.dll

Consulte también

GetNtmsUIOptions

funciones de control de biblioteca de