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
[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
[in] dwType
Este parámetro puede tener uno de los siguientes valores.
[in] dwOperation
Este parámetro puede tener uno de los siguientes valores.
[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 |
---|---|
|
Se deniega el acceso a uno o varios objetos RSM. |
|
El destino especificado ya existe en la lista. |
|
Falta el identificador de sesión o no es válido. |
|
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 de asignación durante el procesamiento. |
|
El GUID especificado por lpObjectId no es el GUID de ningún objeto de equipo o biblioteca en la base de datos. |
|
La función se realizó correctamente. |
Observaciones
Una llamada a
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 |