Compartilhar via

Função DesalocadoNtmsMedia (ntmsapi.h)

  • Artigo

[O Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A função DeallocateNtmsMedia desaloca o lado associado à mídia lógica especificada.

Sintaxe

DWORD DeallocateNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
       DWORD       dwOptions
);

Parâmetros

[in] hSession

Manipule para a sessão retornada pela função OpenNtmsSession .

[in] lpMediaId

Identificador exclusivo da LMID (mídia lógica).

dwOptions

Reservados; deve ser zero.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS para o pool de mídia da mídia é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: NTMS_MODIFY_ACCESS para o pool de mídia da mídia é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
ERROR_DATABASE_FAILURE
 O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL
 O banco de dados está cheio.
ERROR_INVALID_HANDLE
 O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_MEDIA
 O LMID não é válido.
ERROR_INVALID_PARAMETER
 A ID do pool de mídia ou mídia está ausente.
ERROR_INVALID_PARTITION
 O lado LMID não é válido.
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação durante o processamento.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

Quando um meio lógico é desalocado com a função DeallocateNtmsMedia , o RSM coloca o lado associado à mídia lógica no estado de mídia Disponível ou Desativado. A mídia lógica é excluída do sistema quando a mídia lógica é desalocada.

Os lados serão desativados após a desalocação se o lado tiver sido alocado o número máximo de vezes especificado no pool de mídia. Depois que a mídia estiver no estado Desativado, ela não poderá ser alocada novamente.

Windows Server 2003: Se a mídia estiver sendo retornada para o pool gratuito, será necessário NTMS_USE_ACCESS para o pool gratuito e NTMS_CONTROL_ACCESS para o pool de origem. Se o pool gratuito não for o pool de mídia de destino, NTMS_CONTROL_ACCESS será necessário nos pools de origem e de destino.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntmsapi.h
Biblioteca Ntmsapi.lib
DLL Ntmsapi.dll

Confira também

AllocateNtmsMedia

Funções dos Serviços de Mídia