estrutura NTMS_LIBREQUESTINFORMATIONW (ntmsapi.h)

  • Artigo

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

A estrutura de NTMS_LIBREQUESTINFORMATION define as propriedades específicas para uma solicitação de trabalho, que são enfileiradas no RSM.

Sintaxe

typedef struct _NTMS_LIBREQUESTINFORMATIONW {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONW;

Membros

OperationCode

Operação de item. Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_LM_CLASSIFY
 Classifique o meio.
NTMS_LM_CLEANDRIVE
 Limpe uma unidade.
NTMS_LM_DISABLELIBRARY
 Desabilite o alterador.
NTMS_LM_DISABLEDRIVE
 Desabilitar uma unidade.
NTMS_LM_DISABLEMEDIA
 Desabilite o meio.
NTMS_LM_DISMOUNT
 Desmonte o meio de uma unidade.
NTMS_LM_DOORACCESS
 Permitir o acesso à mídia por meio de uma porta de unidade de biblioteca.
NTMS_LM_EJECT
 Ejete o meio da biblioteca.
NTMS_LM_EJECTCLEANER
 Ejete um limpador.
NTMS_LM_ENABLELIBRARY
 Habilite o alterador.
NTMS_LM_ENABLEDRIVE
 Habilitar uma unidade.
NTMS_LM_ENABLEMEDIA
 Habilite o meio.
NTMS_LM_INJECT
 Insira o meio na biblioteca.
NTMS_LM_INJECTCLEANER
 Insira um limpador.
NTMS_LM_INVENTORY
 Execute um inventário da biblioteca.
NTMS_LM_MOUNT
 Monte um lado em uma unidade.
NTMS_LM_PROCESSOMID
 Processe o OMID.
NTMS_LM_RELEASECLEANER
 Libere um slot mais limpo.
NTMS_LM_REMOVE
 Remova um item de trabalho da fila.
NTMS_LM_RESERVECLEANER
 Reserve um slot mais limpo.
NTMS_LM_UPDATEOMID
 Atualize o OMID.
NTMS_LM_WRITESCRATCH
 Escreva um rótulo gratuito.

OperationOption

Opções de item de trabalho (específico do comando).

State

Estado atual deste item de trabalho. Esse pode ser um dos valores a seguir.

Valor Significado
NTMS_LM_QUEUED
 A operação está na fila.
NTMS_LM_INPROCESS
 A operação está sendo processada.
NTMS_LM_PASSED
 Operação concluída com sucesso.
NTMS_LM_FAILED
 A operação foi concluída com um erro.
NTMS_LM_WAITING
 A operação está bloqueada.
NTMS_LM_CANCELLED
 A operação foi cancelada.
NTMS_LM_INVALID
 A operação não é válida.

PartitionId

Identificador exclusivo de um lado que está sendo atendido.

DriveId

Identificador exclusivo de uma unidade que está sendo atendida.

PhysMediaId

Identificador exclusivo de uma parte da mídia física que está sendo atendida.

Library

Biblioteca para esta solicitação.

SlotId

Identificador exclusivo de um slot da parte da mídia física que está sendo atendida.

TimeQueued

Hora do sistema em que essa solicitação foi enfileirada no RSM.

TimeCompleted

Hora do sistema em que essa solicitação foi concluída pelo RSM.

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.

dwErrorCode

Retorno de erro para solicitações que retornam com NTMS_LM_FAILED de estado. Este é um código de erro do sistema.

WorkItemId

ID do item de trabalho associado para esta solicitação. Atualmente, isso é usado para conter a ID do item de trabalho a ser cancelada em uma solicitação de NTMS_LM_REMOVE.

dwPriority

Prioridade do item de trabalho.

Comentários

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

O GUID nos horários de trabalho pode se tornar indisp válido ao longo do tempo. Por exemplo, uma ejeção de um meio livre exclui o PMID depois que a mídia é ejetada. No entanto, o item de trabalho não é atualizado após a conclusão da ejeção.

Observação

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