Função WaitForNtmsOperatorRequest (ntmsapi.h)

[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o Windows Server 2008 R2.]

A função WaitForNtmsOperatorRequest aguarda a solicitação do operador RSM especificada.

Sintaxe

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

Parâmetros

[in] hSession

Identificador para a sessão retornada pela função OpenNtmsSession .

[in] lpRequestId

Identificador de solicitação de operador criado pela função SubmitNtmsOperatorRequest .

[in] dwTimeout

Número de milissegundos a aguardar. Para marcar para uma solicitação de operador, passe um valor de tempo limite igual a zero. Se você especificar um valor infinite, essa função não fará o tempo limite.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor	Significado
ERROR_CANCELLED	A solicitação do operador foi cancelada por um administrador.
ERROR_INVALID_HANDLE	O valor especificado no parâmetro hSession é NULL ou não é válido.
ERROR_INVALID_PARAMETER	Um dos valores de parâmetro não é válido.
ERROR_NOT_CONNECTED	Não é possível se conectar ao serviço RSM.
ERROR_OBJECT_NOT_FOUND	Não é possível localizar o objeto de solicitação do operador. As solicitações de objeto são liberadas do banco de dados. O aplicativo deve chamar uma função como AllocateNtmsMedia se o RSM retornar esse erro.
ERROR_SUCCESS	A função foi bem-sucedida.
ERROR_TIMEOUT	O tempo especificado no parâmetro dwTimeout decorrido antes da conclusão da solicitação do operador.

Comentários

As solicitações de operador especificadas com a função WaitForNtmsOperatorRequest são usadas para solicitar mídia, para solicitar que o meio seja movido de uma biblioteca para outra ou para solicitar o serviço de dispositivo RSM.

Um aplicativo usa WaitForNtmsOperatorRequest para aguardar a resolução de uma solicitação de operador. A solicitação pode ser atendida, rejeitada, excluída ou atingiu o tempo limite.

Normalmente, os aplicativos usam a função SubmitNtmsOperatorRequest para enviar solicitações de operador e usar a função WaitForNtmsOperatorRequest para aguardar sua resolução.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntmsapi.h
Biblioteca	Ntmsapi.lib
DLL	Ntmsapi.dll

Confira também

CancelNtmsOperatorRequest

Funções de solicitação de operador

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest