estrutura NTMS_LIBREQUESTINFORMATIONA (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_LIBREQUESTINFORMATION define as propriedades específicas para uma solicitação de trabalho, que são enfileiradas no RSM.

Sintaxe

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  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;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

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	Desabilite 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 changer.
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 de limpeza.
NTMS_LM_REMOVE	Remova um item de trabalho da fila.
NTMS_LM_RESERVECLEANER	Reserve um slot de limpeza.
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 êxito.
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 sendo atendida.

PhysMediaId

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

Library

Biblioteca para essa 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 é umde código de erro do sistema .

WorkItemId

ID do item de trabalho associado para essa solicitação. No momento, 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.

Observações

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

O GUID nos horários de trabalho pode se tornar não 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.

Nota

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 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