Función SubmitNtmsOperatorRequestA (ntmsapi.h)

Artículo
11/20/2024

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

La función SubmitNtmsOperatorRequest envía una solicitud de operador RSM.

Sintaxis

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Parámetros

[in] hSession

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

[in] dwRequest

Tipo de solicitud de operador. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
NTMS_OPREQ_CLEANER	RSM envía una solicitud de operador para insertar un limpiador cuando se pone en cola una operación limpia y no hay ningún limpiador disponible para la unidad. El parámetro lpArg1Id puede ser un identificador de biblioteca o ranura. Requiere NTMS_CONTROL_ACCESS a la biblioteca. Windows XP: No se requieren derechos de acceso.
NTMS_OPREQ_DEVICESERVICE	Una aplicación o RSM envía una solicitud de operador para el servicio de unidad cuando un dispositivo o unidad del modificador está experimentando problemas. El parámetro lpArg1Id especifica el dispositivo que necesita servicio. Este parámetro puede ser un identificador de iedoor, biblioteca, medios físicos o unidad. Requiere NTMS_CONTROL_ACCESS a la biblioteca. Windows XP: No se requieren derechos de acceso.
NTMS_OPREQ_MESSAGE	Solo mensaje de aplicación. Requiere NTMS_USE_ACCESS al equipo. Windows XP: No se requieren derechos de acceso.
NTMS_OPREQ_MOVEMEDIA	Una aplicación o RSM envía una solicitud de operador para mover elementos multimedia de una biblioteca a otra para un montaje de medios sin conexión o expulsar los medios existentes a la biblioteca sin conexión. El parámetro lpArg1Id especifica la parte de medios físicos que se deben mover y el parámetro lpArg2Id especifica la biblioteca de destino. Requiere NTMS_CONTROL_ACCESS al grupo de medios. Windows XP: No se requieren derechos de acceso.
NTMS_OPREQ_NEWMEDIA	Una aplicación o RSM envía una solicitud de operador para los nuevos medios cuando no hay ningún medio disponible. El parámetro lpArg1Id especifica el objeto del grupo de medios y el parámetro lpArg2Id es el identificador de biblioteca opcional al que agregar el nuevo medio. Requiere NTMS_CONTROL_ACCESS al grupo de medios. Windows XP: No se requieren derechos de acceso.

[in] lpMessage

Cadena de mensaje opcional que se va a enviar al usuario.

[in] lpArg1Id

Identificador de objeto de la solicitud de operador. Consulte las descripciones de los valores del parámetro dwRequest para obtener una descripción del tipo de objeto que se debe pasar para este parámetro.

[in] lpArg2Id

Identificador de objeto de la solicitud de operador. Consulte las descripciones de los valores del parámetro dwRequest para obtener más información sobre el tipo de objeto que se debe pasar para este parámetro.

[out] lpRequestId

Puntero a un búfer que recibe el identificador de la solicitud de operador que se creó.

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_DATABASE_FAILURE	Error en la consulta o actualización de la base de datos.
ERROR_INVALID_HANDLE	El valor especificado en el parámetro hSession es NULL o no es válido.
ERROR_INVALID_PARAMETER	Uno de los valores de parámetro no es válido.
ERROR_NOT_CONNECTED	No se puede conectar al servicio RSM.
ERROR_OBJECT_NOT_FOUND	No se puede encontrar el objeto de origen o destino.
ERROR_SUCCESS	La función se realizó correctamente.

Observaciones

La función SubmitNtmsOperatorRequest envía una solicitud de operador y devuelve el estado de la solicitud (satisfecho o cancelado) o agota el tiempo de espera (si el operador no actúa tras la solicitud). Las solicitudes de operador se usan para solicitar medios, para solicitar que el medio especificado se mueva de una biblioteca a otra, o para solicitar el servicio de dispositivo RSM.

El valor NTMS_OPEREQ_MESSAGE (en el parámetro dwRequest) es el tipo de solicitud que suelen usar las aplicaciones. RSM no puede usar NTMS_OPEREQ_MESSAGE. RSM usa los otros tipos de solicitud según sea necesario.

Nota

El encabezado ntmsapi.h define SubmitNtmsOperatorRequest 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