estrutura VDS_LUN_PROP (vdshwprv.h)

Artigo
03/03/2024

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define as propriedades de um objeto LUN.

Sintaxe

typedef struct _VDS_LUN_PROP {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  LPWSTR               pwszUnmaskingList;
  ULONG                ulFlags;
  VDS_LUN_TYPE         type;
  VDS_LUN_STATUS       status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  SHORT                sRebuildPriority;
} VDS_LUN_PROP, *PVDS_LUN_PROP;

Membros

id

O GUID do objeto LUN.

ullSize

O tamanho do LUN, em bytes.

pwszFriendlyName

O nome do LUN; uma cadeia de caracteres legível e com terminação zero.

pwszIdentification

O identificador lun exclusivo; uma cadeia de caracteres legível e com terminação zero.

pwszUnmaskingList

Uma lista que especifica os computadores na rede a serem autorizados a acessar o LUN; uma cadeia de caracteres delimitada por ponto e vírgula, terminada em NULL e legível por humanos.

Se o valor for "*", todos os computadores na rede receberão acesso ao LUN. Se o valor for "", nenhum computador terá acesso ao LUN.

Nota Na prática, se o valor for "*", a maioria dos provedores de hardware concederá apenas às portas e iniciadores no computador local acesso ao LUN.

Se "*" ou "" for especificado, nenhum outro valor poderá ser especificado.

Para redes Fibre Channel e redes SAS (SCS) anexadas em série, cada entrada é um WWN (Nome mundial) de 64 bits de cada porta à qual o LUN é desmascarado, formatado como uma cadeia de caracteres hexadecimal (16 caracteres de comprimento), primeiro byte mais significativo. Por exemplo, um endereço WWN de 01:23:45:67:89:AB:CD:EF é representado como "0123456789ABCDEF". Para obter mais informações, consulte as especificações T10 para Fibre Channel e SAS.

Para redes iSCSI, cada entrada é um IQN (nome qualificado iSCSI) de cada iniciador no qual o LUN é desmascarado. Um LUN desmascarado para um iniciador específico é considerado associado a esse iniciador.

Nota A lista de desmascaramento pode conter o mesmo WWN ou IQN mais de uma vez. As duplicatas são ignoradas.

ulFlags

Os sinalizadores LUN enumerados por VDS_LUN_FLAG.

type

O tipo LUN enumerado por VDS_LUN_TYPE.

status

O status do objeto LUN enumerado por VDS_LUN_STATUS.

health

Um VDS_HEALTH valor de enumeração que especifica o estado de integridade do LUN. Veja a seguir os valores válidos para esse membro.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_REBUILDING (2)

VDS_H_FAILING (4)

VDS_H_FAILING_REDUNDANCY (5)

VDS_H_FAILED_REDUNDANCY (6)

VDS_H_FAILED_REDUNDANCY_FAILING (7)

VDS_H_FAILED (8)

TransitionState

O estado de transição do LUN enumerado por VDS_TRANSITION_STATE.

sRebuildPriority

A prioridade de recompilação do objeto LUN. Um valor entre 0 (prioridade mais baixa) e 15 (prioridade mais alta).

Comentários

O método IVdsLun::GetProperties retorna essa estrutura para relatar as propriedades de um objeto LUN.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	vdshwprv.h