Función SubmitNtmsOperatorRequestW (ntmsapi.h)

Artículo
03/08/2023

[El 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 SubmitNtmsOperatorRequestW(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCWSTR     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 valores siguientes.

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 de cambio 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 en el 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 medios de una biblioteca a otra para un montaje de medios sin conexión o para 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 nuevos medios cuando no hay ningún medio disponible. El parámetro lpArg1Id especifica el objeto de grupo de medios y el parámetro lpArg2Id es el identificador de biblioteca opcional al que se va a 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 para la solicitud del 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 para la solicitud del operador. Consulte las descripciones de los valores del parámetro dwRequest para obtener más información sobre qué tipo de objeto 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 valores siguientes.

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 encuentra el objeto de origen o destino.
ERROR_SUCCESS	La función se realizó correctamente.

Comentarios

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