estrutura NTMS_OPREQUESTINFORMATIONA (ntmsapi.h)

Artigo
11/20/2024

[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 para o 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 do Arg1 deverá ser definido como o GUID do pool de mídia que exige novas mídias. Opcionalmente, o membro do 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 limpa é enfileirada e nenhum limpador está online e disponível para a unidade. Quando esse sinalizador é definido, o membro do Arg1 deve 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 do Arg1 deverá ser definido como o GUID do serviço que exige o dispositivo.
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 for definido, o membro do Arg1 deverá ser definido como GUID da mídia física a ser movida e o membro do do Arg2 deve ser definido como 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 de 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á no processo de executar o 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 noArg1Type .
NTMS_CHANGER	Objeto changer médio.
NTMS_DRIVE	Objeto drive.
NTMS_IEDOOR	Objeto da porta da biblioteca.
NTMS_IEPORT.	Objeto de porta de inserção/ejeção de 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

Arg1 ID de objeto 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 do operador. Para obter os usos apropriados de Arg1, consulte a descrição de solicitação de .

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

Arg2 ID de objeto 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 do operador. Para obter os usos apropriados de Arg2, consulte a descrição do de solicitação de .

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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	ntmsapi.h

Consulte também

NTMS_OBJECTINFORMATION

Compartilhar via