Função SubmitNtmsOperatorRequestW (ntmsapi.h)

Artigo
08/25/2023

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

A função SubmitNtmsOperatorRequest envia uma solicitação de operador RSM.

Sintaxe

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

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

[in] dwRequest

Tipo de solicitação de operador. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
NTMS_OPREQ_CLEANER	O RSM envia uma solicitação de operador para inserir um limpador quando uma operação de limpo está na fila e nenhum limpador está disponível para a unidade. O parâmetro lpArg1Id pode ser uma biblioteca ou um identificador de slot. Requer NTMS_CONTROL_ACCESS para a biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQ_DEVICESERVICE	Um aplicativo ou RSM envia uma solicitação de operador para o serviço de unidade quando um dispositivo ou unidade de alteração está enfrentando problemas. O parâmetro lpArg1Id especifica o dispositivo que precisa de serviço. Esse parâmetro pode ser um identificador iedoor, biblioteca, mídia física ou identificador de unidade. Requer NTMS_CONTROL_ACCESS para a biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQ_MESSAGE	Somente mensagem do aplicativo. Requer NTMS_USE_ACCESS para o computador. Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQ_MOVEMEDIA	Um aplicativo ou RSM envia uma solicitação de operador para mover a mídia de uma biblioteca para outra para uma montagem de mídia offline ou para ejetar a mídia existente para a biblioteca offline. O parâmetro lpArg1Id especifica a parte da mídia física que deve ser movida e o parâmetro lpArg2Id especifica a biblioteca de destino. Requer NTMS_CONTROL_ACCESS para o pool de mídia. Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQ_NEWMEDIA	Um aplicativo ou RSM envia uma solicitação de operador para nova mídia quando nenhuma mídia está disponível. O parâmetro lpArg1Id especifica o objeto do pool de mídia e o parâmetro lpArg2Id é o identificador de biblioteca opcional ao qual adicionar o novo meio. Requer NTMS_CONTROL_ACCESS para o pool de mídia. Windows XP: Nenhum direito de acesso é necessário.

[in] lpMessage

Cadeia de caracteres de mensagem opcional a ser enviada ao usuário.

[in] lpArg1Id

Identificador de objeto para a solicitação do operador. Consulte as descrições dos valores no parâmetro dwRequest para obter uma descrição de qual tipo de objeto deve ser passado para esse parâmetro.

[in] lpArg2Id

Identificador de objeto para a solicitação do operador. Consulte as descrições dos valores no parâmetro dwRequest para obter detalhes sobre qual tipo de objeto deve ser passado para esse parâmetro.

[out] lpRequestId

Ponteiro para um buffer que recebe o identificador da solicitação de operador que foi criada.

Retornar valor

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

Valor	Significado
ERROR_ACCESS_DENIED	O acesso a um ou mais objetos RSM é negado.
ERROR_DATABASE_FAILURE	Falha na consulta ou atualização do banco de dados.
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 origem ou de destino.
ERROR_SUCCESS	A função foi bem-sucedida.

Comentários

A função SubmitNtmsOperatorRequest envia uma solicitação de operador e retorna o status da solicitação (Satisfeito ou Cancelado) ou atinge o tempo limite (se o operador não agir após a solicitação). As solicitações de operador são usadas para solicitar mídia, para solicitar que o meio especificado seja movido de uma biblioteca para outra ou para solicitar o serviço de dispositivo RSM.

O valor NTMS_OPEREQ_MESSAGE (no parâmetro dwRequest ) é o tipo de solicitação usado com mais frequência por aplicativos. O RSM não pode usar NTMS_OPEREQ_MESSAGE. O RSM usa os outros tipos de solicitação conforme necessário.

Observação

O cabeçalho ntmsapi.h define SubmitNtmsOperatorRequest como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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