Compartir a través de

Función WaitForNtmsOperatorRequest (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 WaitForNtmsOperatorRequest espera la solicitud de operador RSM especificada.

Sintaxis

DWORD WaitForNtmsOperatorRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwTimeout
);

Parámetros

[in] hSession

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

[in] lpRequestId

Identificador de solicitud de operador creado por la función SubmitNtmsOperatorRequest .

[in] dwTimeout

Número de milisegundos que se van a esperar. Para comprobar si hay una solicitud de operador, pase un valor de tiempo de espera de cero. Si especifica un valor de INFINITE, esta función no agota el tiempo de espera.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_CANCELLED
 Un administrador canceló la solicitud de operador.
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 solicitud del operador. Las solicitudes de objeto se vacían de la base de datos. La aplicación debe llamar a una función como AllocateNtmsMedia si RSM devuelve este error.
ERROR_SUCCESS
 La función se realizó correctamente.
ERROR_TIMEOUT
 La hora especificada en el parámetro dwTimeout transcurrió antes de la finalización de la solicitud del operador.

Comentarios

Las solicitudes de operador especificadas con la función WaitForNtmsOperatorRequest se usan para solicitar medios, solicitar que el medio se mueva de una biblioteca a otra o para solicitar el servicio de dispositivo RSM.

Una aplicación usa WaitForNtmsOperatorRequest para esperar la resolución de una solicitud de operador. La solicitud se puede satisfacer, rechazar, eliminar o agotar el tiempo de espera.

Normalmente, las aplicaciones usan la función SubmitNtmsOperatorRequest para enviar solicitudes de operador y usar la función WaitForNtmsOperatorRequest para esperar su resolució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

CancelNtmsOperatorRequest

Funciones de solicitud de operador

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest