Função ReserveNtmsCleanerSlot (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 ReserveNtmsCleanerSlot reserva um único slot em uma unidade de biblioteca para um cartucho de limpador de unidade.

Sintaxe

DWORD ReserveNtmsCleanerSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibrary,
  [in] LPNTMS_GUID lpSlot
);

Parâmetros

[in] hSession

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

[in] lpLibrary

Identificador exclusivo da biblioteca para reservar o slot mais limpo.

[in] lpSlot

Identificador exclusivo do slot que deve ser reservado para um cartucho mais limpo.

Valor retornado

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS para a biblioteca é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
ERROR_ALREADY_RESERVED
 Esse slot ou outro slot na biblioteca já foi reservado para limpeza. Para alterar o slot de cartucho mais limpo, o slot de limpeza atualmente reservado deve ser liberado primeiro, usando a função ReleaseNtmsCleanerSlot .
ERROR_DEVICE_NOT_AVAILABLE
 No momento, a biblioteca não está conectada.
ERROR_INVALID_HANDLE
 O valor especificado no parâmetro hSession não é válido.
ERROR_INVALID_SLOT
 Não é possível recuperar a definição de slot do banco de dados.
ERROR_NOT_CONNECTED
 Não é possível se conectar ao serviço RSM.
ERROR_SLOT_FULL
 Um slot de limpador não está reservado. O slot especificado tem mídia. A reserva só pode ser executada em um slot vazio.
ERROR_SLOT_NOT_PRESENT
 Um slot de limpador não está reservado. O slot especificado atualmente não está instalado na biblioteca. Esse erro ocorrerá se pelo menos uma revista de cartucho estiver ausente na biblioteca.
ERROR_SUCCESS
 A função foi enfileirada com êxito.

Comentários

O slot reservado com a função ReserveNtmsCleanerSlot deve estar presente e vazio. A biblioteca ainda não deve ter um slot reservado para um cartucho mais limpo.

Requisitos

   
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

CleanNtmsDrive

Funções de gerenciamento mais limpas

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot