estrutura NTMS_OPREQUESTINFORMATIONA (ntmsapi.h)

  • Artigo

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

A estrutura NTMS_OPREQUESTINFORMATION define as propriedades específicas do controle do sistema de solicitação de operador para RSM.

Sintaxe

typedef struct _NTMS_OPREQUESTINFORMATIONA {
  DWORD      Request;
  SYSTEMTIME Submitted;
  DWORD      State;
  CHAR       szMessage[NTMS_MESSAGE_LENGTH];
  DWORD      Arg1Type;
  NTMS_GUID  Arg1;
  DWORD      Arg2Type;
  NTMS_GUID  Arg2;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
} NTMS_OPREQUESTINFORMATIONA;

Membros

Request

Tipo de solicitação de operador. Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_OPREQ_NEWMEDIA
 Um aplicativo que tenta alocar mídia envia uma solicitação de operador para novas mídias quando nenhuma mídia está disponível. Quando esse sinalizador for definido, o membro Arg1 deverá ser definido como o GUID do pool de mídia que exige novas mídias. Opcionalmente, o membro Arg2 pode ser definido como a biblioteca específica na qual a nova mídia deve ser colocada.
NTMS_OPREQ_CLEANER
 O RSM envia uma solicitação de operador para um faxineiro quando uma operação de limpo é enfileirada e nenhum limpador está online e disponível para a unidade. Quando esse sinalizador for definido, o membro Arg1 deverá ser definido como o GUID da biblioteca que exige o cartucho de limpeza.
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. Quando esse sinalizador for definido, o membro Arg1 deverá ser definido como o GUID do dispositivo que exige serviço.
NTMS_OPREQ_MOVEMEDIA
 Um aplicativo ou RSM envia uma solicitação de operador para mover o meio especificado para atender a uma montagem para mídia offline ou ejetar mídia para uma biblioteca offline. Quando esse sinalizador é definido, o membro Arg1 deve ser definido como o GUID da mídia física a ser movida e o membro Arg2 deve ser definido como o GUID da biblioteca para a qual essa mídia deve ser movida.
NTMS_OPREQ_MESSAGE
 Uma solicitação de operador específica do aplicativo. Somente texto.

Submitted

Hora do sistema em que a solicitação do operador foi enviada.

State

Estado atual da solicitação de serviço do operador. Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_OPSTATE_SUBMITTED
 A solicitação do operador foi enviada, mas não lida por um console do operador.
NTMS_OPSTATE_ACTIVE
 A solicitação do operador foi lida por um ou mais consoles de operador e pode estar em processo.
NTMS_OPSTATE_INPROGRESS
 O usuário reconheceu essa solicitação de operador e está em processo de execução do serviço.
NTMS_OPSTATE_REFUSED
 O usuário rejeitou a solicitação de serviço do operador.
NTMS_OPSTATE_COMPLETE
 O usuário concluiu a solicitação de serviço do operador.

szMessage[NTMS_MESSAGE_LENGTH]

Texto da mensagem do operador.

Arg1Type

Tipo do objeto Arg1 . Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_UNKNOWN
 Nenhum objeto fornecido em Arg1Type.
NTMS_CHANGER
 Objeto de alterador médio.
NTMS_DRIVE
 Objeto drive.
NTMS_IEDOOR
 Objeto de porta da biblioteca.
NTMS_IEPORT.
 Objeto de porta de inserção/ejeção da biblioteca
NTMS_LIBRARY
 Objeto Library.
NTMS_PARTITION
 Objeto lateral.
NTMS_PHYSICAL_MEDIA
 Objeto de mídia física.
NTMS_STORAGESLOT
 Objeto de slot de biblioteca.

Arg1

ID do objeto Arg1 usada para solicitações de movimentação ou outras solicitações de operador que exigem um objeto de referência. A finalidade desse objeto varia de acordo com o tipo de solicitação de operador. Para obter os usos apropriados do Arg1, consulte a Descrição da solicitação .

Arg2Type

Tipo de objeto Arg2 . Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_UNKNOWN
 Nenhum objeto fornecido em Arg2Type.
NTMS_LIBRARY
 Objeto Library.

Arg2

ID do objeto Arg2 usada para solicitações de operador que exigem um segundo objeto de referência. A finalidade desse objeto varia de acordo com o tipo de solicitação de operador. Para obter os usos apropriados do Arg2, consulte a Descrição da solicitação .

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Aplicativo que enviou a solicitação do operador.

szUser[NTMS_USERNAME_LENGTH]

O usuário interativo fez logon no computador que enviou a solicitação do operador.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Computador que enviou a solicitação do operador.

Comentários

A estrutura NTMS_OPREQUESTINFORMATION está incluída na estrutura NTMS_OBJECTINFORMATION .

Observação

O cabeçalho ntmsapi.h define NTMS_OPREQUESTINFORMATION 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]
Cabeçalho ntmsapi.h

Confira também

NTMS_OBJECTINFORMATION