Função AccessNtmsLibraryDoor (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 AccessNtmsLibraryDoor desbloqueia a porta da biblioteca especificada. Se a biblioteca estiver ocupada, o RSM enfileira a solicitação e retorna com êxito.

Sintaxe

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Parâmetros

[in] hSession

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

[in] lpLibraryId

Identificador exclusivo do objeto de biblioteca. Essa biblioteca deve dar suporte ao acesso à porta.

[in] dwAction

Ação a ser executada. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
NTMS_INVENTORY_NONE	Depois que o usuário fecha a porta, nenhum inventário é executado. No entanto, se um rótulo de montagem marcar falhar, um inventário será executado.
NTMS_INVENTORY_OMID	Depois que o usuário fecha a porta, um inventário completo na mídia é executado. Isso pode ser demorado porque cada lado de cada meio deve ser montado.
NTMS_INVENTORY_FAST	Se a biblioteca tiver um leitor de código de barras instalado, esse sinalizador fará com que o inventário de código de barras seja executado. Se a biblioteca não tiver um leitor de código de barras, esse sinalizador fará com que um inventário diferencial seja executado. Os OMIDs são verificados em cada meio colocado em um slot vazio enquanto a porta está aberta.
NTMS_INVENTORY_DEFAULT	Use o InventoryMethod especificado no objeto de biblioteca (consulte NTMS_LIBRARYINFORMATION).

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_DATABASE_FAILURE	O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL	O banco de dados está cheio.
ERROR_INVALID_HANDLE	A ID da sessão está ausente ou não é válida.
ERROR_INVALID_PARAMETER	A ID da biblioteca está ausente.
ERROR_LIBRARY_OFFLINE	A ID da biblioteca faz referência a uma biblioteca offline sem uma porta.
ERROR_NOT_ENOUGH_MEMORY	Ocorreu uma falha de alocação durante o processamento.
ERROR_RESOURCE_DISABLED	A biblioteca está desabilitada.
ERROR_RESOURCE_NOT_PRESENT	A biblioteca não tem uma porta.
ERROR_SUCCESS	O acesso à porta está na fila.

Comentários

Algumas bibliotecas não fornecem meios para que o RSM bloqueie e desbloqueie programaticamente suas portas. O comportamento dessa função com essas bibliotecas é idêntico ao seu comportamento com bibliotecas que o RSM pode desbloquear e bloquear.

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

EjectNtmsMedia

InjectNtmsMedia

Funções de controle de biblioteca