Compartilhar via


Função ReleaseNtmsCleanerSlot (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 ReleaseNtmsCleanerSlot remove uma reserva de slot existente para um cartucho de limpeza. Em seguida, o slot pode ser usado para cartuchos de dados.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpLibrary

Identificador exclusivo da biblioteca para liberar o slot mais limpo.

Retornar valor

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_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_NOT_CONNECTED
Não é possível se conectar ao serviço RSM.
ERROR_NO_SLOT_RESERVED
Esta biblioteca não tem nenhum slot reservado para um cartucho mais limpo.
ERROR_SLOT_FULL
A biblioteca tem um slot de cartucho de limpeza reservado, mas o slot contém um cartucho mais limpo (o slot deve estar vazio). Use a função EjectNtmsCleaner para ejetar um cartucho mais limpo.
ERROR_SLOT_NOT_PRESENT
A biblioteca tem um slot de cartucho de limpeza reservado, mas o slot especificado atualmente não está instalado na biblioteca. Esse erro poderá ocorrer se pelo menos uma revista estiver ausente na biblioteca.
ERROR_SUCCESS
A função foi enfileirada com êxito.

Comentários

Para que a função ReleaseNtmsCleanerSlot tenha êxito, o slot deve estar presente e vazio. A biblioteca também deve ter um slot reservado para limpeza.

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

CleanNtmsDrive

Funções de gerenciamento mais limpas

EjectNtmsCleaner

InjectNtmsCleaner

ReserveNtmsCleanerSlot