NTMS_PMIDINFORMATIONA estrutura (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_PMIDINFORMATION define as propriedades específicas para um objeto de mídia física.

Sintaxe

typedef struct _NTMS_PMIDINFORMATIONA {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID MediaType;
  NTMS_GUID HomeSlot;
  CHAR      szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  CHAR      szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATIONA;

Membros

CurrentLibrary

ID exclusiva da biblioteca na qual a mídia está contida.

MediaPool

ID exclusiva do pool de mídia ao qual a mídia é atribuída.

Location

ID exclusiva do objeto de local físico para a mídia.

LocationType

Tipo de local atual de uma parte da mídia física. O valor desse membro pode ser definido como NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT. (A mídia offline está em slots.)

MediaType

ID exclusiva de um objeto de tipo de mídia.

HomeSlot

ID exclusiva do slot de armazenamento da biblioteca no qual a mídia é armazenada.

szBarCode[NTMS_BARCODE_LENGTH]

Cadeia de caracteres que corresponde ao valor de código de barras em um rótulo de código de barras de uma parte da mídia física.

BarCodeState

Estado atual do código de barras. Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_BARCODESTATE_OK	A mídia tem um código de barra e é legível.
NTMS_BARCODESTATE_UNREADABLE	A mídia não tem um código de barra ou o código de barra é ilegível.

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

Número sequencial atribuído ao meio especificado como um valor legível por humanos que deve ser transcrito por um usuário no meio para que o meio possa ser localizado em uma biblioteca offline.

MediaState

Estado atual para a parte da mídia física. Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_MEDIASTATE_IDLE	A mídia está em um slot na biblioteca, em uma unidade desmontada ou em uma biblioteca offline.
NTMS_MEDIASTATE_INUSE	A mídia é marcada como em uso assim que uma solicitação de uma operação é feita com êxito no RSM.
NTMS_MEDIASTATE_LOADED	O estado da mídia quando o RSM determinou que a mídia está disponível para leitura e gravação.
NTMS_MEDIASTATE_MOUNTED	O estado de uma parte da mídia física quando a mídia é colocada em uma unidade.
NTMS_MEDIASTATE_OP_ERROR	A mídia física está em um estado de erro que é recuperável. Nenhuma intervenção de operador é necessária.
NTMS_MEDIASTATE_UNLOADED	O estado da mídia quando ela estiver pronta para ser removida de uma unidade. O estado da unidade, DISMOUNTABLE, também indica que uma unidade pode ser removida a qualquer momento.
NTMS_MEDIASTATE_OPREQ	A mídia está aguardando a solicitação do operador.

dwNumberOfPartitions

Número de lados no meio.

dwMediaTypeCode

Código de tipo de mídia SCSI.

dwDensityCode

Código de densidade SCSI.

MountedPartition

ID globalmente exclusiva do lado da mídia que está montada no momento.

Observações

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

Nota

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