Función WaitForNtmsOperatorRequest (ntmsapi.h)

[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