Função ReleaseNtmsCleanerSlot (ntmsapi.h)

Artigo
02/29/2024

[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