Função ReserveNtmsCleanerSlot (ntmsapi.h)

[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