IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Os metadados associados a uma banda são definidos com uma solicitação IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA . Os metadados de uma banda servem como uma área de dados para um aplicativo do gerenciador de chaves.
Código principal
Buffer de entrada
O buffer de entrada em Irp-AssociatedIrp.SystemBuffer> deve conter um SET_BAND_METADATA_PARAMETERS e, possivelmente, uma estrutura AUTH_KEY juntamente com os novos metadados a serem definidos para a banda.
Se o membro AuthKeyOffset do SET_BAND_METADATA_PARAMETERS estiver definido como EHSTOR_BANDMGR_NO_KEY, os dados de entrada no buffer do sistema não precisarão incluir uma estrutura de AUTH_KEY .
Comprimento do buffer de entrada
Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ser pelo menos sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY).
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
Um dos seguintes valores pode ser retornado no campo Status :
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | Os metadados foram definidos para a banda selecionada. |
| STATUS_INVALID_DEVICE_REQUEST | O dispositivo de armazenamento não dá suporte ao gerenciamento de banda. |
| STATUS_INVALID_BUFFER_SIZE | O tamanho do buffer de entrada está incorreto. |
| STATUS_INVALID_PARAMETER | As informações no buffer de entrada são inválidas. |
| STATUS_NOT_FOUND | A banda não foi encontrada para os critérios de seleção fornecidos. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
Comentários
Os metadados também podem ser apagados usando esse IOCTL. Para apagar metadados de uma banda, defina a parte de metadados do buffer de entrada como todos os zeros ou algum outro padrão de apagamento. Para garantir a remoção de informações confidenciais em blobs de metadados, essa operação de apagamento deve ser executada antes de excluir uma banda da tabela de banda do driver de silo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível em Windows 8 e versões posteriores do Windows. |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |