Compartilhar via

Função GetNtmsObjectInformation (ntmsapi.h)

  • Artigo

[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 GetNtmsObjectInformation retorna a estrutura de informações de um objeto para o objeto especificado.

Sintaxe

DWORD GetNtmsObjectInformation(
  [in]  HANDLE                   hSession,
  [in]  LPNTMS_GUID              lpObjectId,
  [out] LPNTMS_OBJECTINFORMATION lpInfo
);

Parâmetros

[in] hSession

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

[in] lpObjectId

Identificador exclusivo do objeto RSM.

[out] lpInfo

Ponteiro para uma estrutura NTMS_OBJECTINFORMATION que recebe as informações do objeto.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS para o objeto ou seu contêiner é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: Nenhum direito de acesso é necessário.
ERROR_INVALID_HANDLE
 O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_PARAMETER
 A ID do objeto ou a estrutura de informações está ausente ou o tamanho das informações do objeto ou o tipo de objeto não é válido.
ERROR_NOT_ENOUGH_MEMORY
 Ocorreu uma falha de alocação durante o processamento.
ERROR_OBJECT_NOT_FOUND
 A ID do objeto não é válida.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

O tamanho das informações e o tipo da estrutura de informações devem ser definidos corretamente no parâmetro lpInfo antes de usar a função GetNtmsObjectInformation .

Para evitar resultados imprevisíveis, os aplicativos devem chamar a função GetNtmsObjectInformation antes de chamar a função SetNtmsObjectInformation . A função SetNtmsObjectInformation atualiza todos os membros graváveis da estrutura NTMS_OBJECTINFORMATION , portanto, o aplicativo é responsável por fornecer um valor para todos os membros graváveis.

Veja a seguir a lista de objetos que exigem direitos de acesso especiais.

Objeto Access
NTMS_CHANGER Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_CHANGER_TYPE Requer NTMS_USE_ACCESS para o computador.
NTMS_COMPUTER Requer NTMS_USE_ACCESS para o computador.
NTMS_DRIVE Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_DRIVE_TYPE Requer NTMS_USE_ACCESS para o computador.
NTMS_IEDOOR Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_IEPORT Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_LIBRARY Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_LIBREQUEST Requer NTMS_USE_ACCESS para a biblioteca.
NTMS_LOGICAL_MEDIA Requer NTMS_USE_ACCESS ao pool de mídia da mídia lógica.
NTMS_MEDIA_TYPE Requer NTMS_USE_ACCESS para o computador.
NTMS_OPREQUEST Requer NTMS_USE_ACCESS para o computador.
NTMS_PARTITION Requer NTMS_USE_ACCESS para o pool de mídia do lado.
NTMS_PHYSICAL_MEDIA Requer NTMS_USE_ACCESS para o pool de mídia.
NTMS_STORAGESLOT Requer NTMS_USE_ACCESS para a biblioteca.

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funções de gerenciamento de objetos

SetNtmsObjectInformation