IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY IOCTL (ehstorbandmgmt.h)

As propriedades de segurança de bandas em um dispositivo de armazenamento gerenciado por banda são modificadas com a solicitação IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY .

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O buffer em Irp-AssociatedIrp.SystemBuffer> deve conter uma estrutura SET_BAND_SECURITY_PARAMETERS seguida pelas estruturas AUTH_KEY e BAND_SECURITY_INFO.

Se o membro AuthKeyOffset do SET_BAND_SECURITY_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 . Além disso, se uma nova chave de autenticação não for fornecida, nenhuma estrutura de chave atualizada será incluída.

Comprimento do buffer de entrada

Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ser pelo menos sizeof (SET_BAND_SECURITY_PARAMETERS) + 2 * sizeof(AUTH_KEY) + sizeof(BAND_SECURITY_INFO) quando todas as estruturas de entrada são necessárias.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

Um dos valores a seguir pode ser retornado no campo Status .

Valor do status	Descrição
STATUS_SUCCESS	As propriedades de segurança da banda foram alteradas.
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 é inválido.
STATUS_INVALID_PARAMETER	As informações no buffer de entrada são inválidas.
STATUS_NOT_FOUND	Uma banda não foi encontrada para os critérios de seleção fornecidos.
STATUS_ACCESS_DENIED	A chave de autenticação fornecida não é válida.
STATUS_IO_DEVICE_ERROR	Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança.

Comentários

O bloqueio e o desbloqueio de leitura e gravação para faixas são definidos com esse IOCTL na estrutura BAND_SECURITY_INFO incluída como entrada no buffer do sistema.

As alterações de chave de autenticação não afetarão o estado de bloqueio da banda. Não é necessário desmontar um volume para alterar uma chave de autenticação com essa solicitação.

Quando uma banda é desbloqueada, o que significa que os membros Readlock ou WriteLock de BAND_SECURITY_INFO são FALSE, o driver de silo armazenará em cache a chave de autenticação fornecida se SETBANDSEC_AUTHKEY_CACHING_ENABLED estiver definido no membro Flags do SET_BAND_SECURITY_PARAMETERS.

Como um caso especial, esse IOCTL pode ser usado para notificar o driver de silo de que uma banda foi desbloqueada sem o uso dos membros de bloqueio em BAND_SECURITY_INFO. Para fazer isso, o membro NewAuthKeyOffset do SET_BAND_SECURITY_PARAMETERS é definido como CurrentAuthKeyOffset com BandSecurityInfoOffset definido como 0. Nesse caso, nenhuma alteração de segurança ocorre, mas a chave fornecida em CurrentAuthKeyOffset é armazenada em cache na memória, desde que SETBANDSEC_AUTHKEY_CACHING_ENABLED seja definida em Sinalizadores.

As alterações feitas na tabela de banda por essa solicitação são confirmadas no dispositivo atomicamente antes da conclusão da solicitação IOCTL. Portanto, é garantido que a banda seja modificada com todas as suas propriedades definidas ou nenhuma propriedade definida caso ocorra uma falha de energia ou sistema.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 8
Cabeçalho	ehstorbandmgmt.h (inclua EhStorBandMgmt.h)

Confira também

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

SET_BAND_SECURITY_PARAMETERS