Função GetNtmsObjectInformationA (ntmsapi.h)

Artigo
11/20/2024

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

Sintaxe

DWORD GetNtmsObjectInformationA(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONA lpInfo
);

Parâmetros

[in] hSession

Manipule 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.

Valor de retorno

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: Não são necessários direitos de acesso.
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.

Observações

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 especiais de acesso.

Objeto	Acesso
NTMS_CHANGER	Requer NTMS_USE_ACCESS à 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 à biblioteca.
NTMS_DRIVE_TYPE	Requer NTMS_USE_ACCESS para o computador.
NTMS_IEDOOR	Requer NTMS_USE_ACCESS à biblioteca.
NTMS_IEPORT	Requer NTMS_USE_ACCESS à biblioteca.
NTMS_LIBRARY	Requer NTMS_USE_ACCESS à biblioteca.
NTMS_LIBREQUEST	Requer NTMS_USE_ACCESS à 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 ao pool de mídia do lado.
NTMS_PHYSICAL_MEDIA	Requer NTMS_USE_ACCESS ao pool de mídia.
NTMS_STORAGESLOT	Requer NTMS_USE_ACCESS à biblioteca.

Nota

O cabeçalho ntmsapi.h define GetNtmsObjectInformation como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ntmsapi.h
biblioteca	Ntmsapi.lib
de DLL	Ntmsapi.dll

Consulte também

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funções de gerenciamento de objetos

SetNtmsObjectInformation

Compartilhar via