Compartilhar via

Método IVdsLunNumber::GetLunNumber (vdshwprv.h)

  • Artigo

[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.]

Recupera o número LUN de um LUN.

Sintaxe

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

Parâmetros

[out] pulLunNumber

O endereço de uma variável que recebe o número LUN. Esse valor é necessário e não pode ser NULL.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.

Comentários

Esse método retorna o número LUN que o provedor de hardware VDS atribuiu ao LUN. Esse número identifica o LUN dentro da matriz de disco. Não é o mesmo que o "Número da Unidade Lógica" no endereço SCSI do disco. Cada LUN na matriz de disco recebe exatamente um número LUN.

Esse método existe porque o utilitário DiskRAID atribui seu próprio índice a cada LUN quando enumera os LUNs em um subsistema. Mas esses índices podem ser alterados sempre que DiskRAID for executado, se o provedor de hardware enumerar os LUNs em uma ordem diferente. Isso pode ser confuso para os usuários finais. Para matrizes de disco que têm seus próprios números LUN (atribuídos pelo provedor), esse método fornece ao chamador a capacidade de mapear os números LUN para os índices LUN atribuídos pelo DiskRAID.

Se um subsistema der suporte à numeração LUN, ele poderá indicar esse suporte definindo o sinalizador VDS_SF_SUPPORTS_LUN_NUMBER no membro ulFlags da estrutura de VDS_SUB_SYSTEM_PROP ou VDS_SUB_SYSTEM_PROP2 . Para obter mais informações sobre esse sinalizador, consulte a enumeração VDS_SUB_SYSTEM_FLAG .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vdshwprv.h
Biblioteca Uuid.lib

Confira também

IVdsLunNumber