Compartilhar via


Função IdentifiNtmsSlot (ntmsapi.h)

[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o Windows Server 2008 R2.]

A função IdentifiNtmsSlot identifica a mídia no slot especificado em uma biblioteca. O comando retorna quando a identificação é concluída.

Sintaxe

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

Parâmetros

[in] hSession

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

[in] lpSlotId

Identificador exclusivo do objeto de slot a ser identificado.

[in] dwOption

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
NTMS_DISMOUNT_DEFERRED
Deixe a mídia na unidade após a conclusão da identificação de mídia, como se tivesse sido desmontada com a opção "adiada".
NTMS_DISMOUNT_IMMEDIATE
Desmonte a mídia na unidade após a conclusão da identificação de mídia.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor Significado
ERROR_ACCESS_DENIED
O acesso a um ou mais objetos RSM foi negado.
ERROR_INVALID_HANDLE
O valor especificado no parâmetro hSession não é válido.
ERROR_INVALID_PARAMETER
A ID do slot ou dwOption não é válida.
ERROR_SUCCESS
A função foi bem-sucedida.

Comentários

Se o slot estiver vazio, a função retornará ERROR_SUCCESS, mas nenhum novo registro de mídia será exibido.

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

InventoryNtmsLibrary

Funções de controle de biblioteca