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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Use o InventoryMethod especificado no objeto de biblioteca (consulte NTMS_LIBRARYINFORMATION). |
Retornar valor
Essa função retorna um dos valores a seguir.
| Valor | Significado |
|---|---|
|
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. |
|
O banco de dados está inacessível ou danificado. |
|
O banco de dados está cheio. |
|
A ID da sessão está ausente ou não é válida. |
|
A ID da biblioteca está ausente. |
|
A ID da biblioteca faz referência a uma biblioteca offline sem uma porta. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
A biblioteca está desabilitada. |
|
A biblioteca não tem uma porta. |
|
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 |