Compartilhar via

Função SetNtmsObjectInformationA (ntmsapi.h)

  • Artigo

[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 SetNtmsObjectInformation altera a estrutura de informações do objeto especificado.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpObjectId

Identificador exclusivo do objeto RSM.

[in] lpInfo

Ponteiro para uma estrutura NTMS_OBJECTINFORMATION .

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS ou NTMS_CONTROL_ACCESS é negado ao objeto que está sendo gravado ou nenhuma modificação é permitida ao tipo de objeto especificado. Consulte Observações.
ERROR_SUCCESS
 A função foi bem-sucedida.
ERROR_DATABASE_FAILURE
 O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL
 O banco de dados está cheio.
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ão ausentes 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.

Comentários

O tamanho e o tipo de informações devem ser definidos antes que você possa usar SetNtmsObjectInformation.

Todas as propriedades graváveis para o objeto são lidas da estrutura NTMS_OBJECTINFORMATION e gravadas no banco de dados sem considerar as operações de gravação que ocorreram entre o momento em que esse aplicativo chamou a função GetNtmsObjectInformation e a função SetNtmsObjectInformation . Por causa disso, você pode perder alterações.

Para evitar resultados imprevisíveis, os aplicativos devem chamar GetNtmsObjectInformation antes de chamar SetNtmsObjectInformation. Conforme observado acima, SetNtmsObjectInformation atualiza todos os membros graváveis, portanto, o aplicativo é responsável por fornecer um valor para todos os membros graváveis.

Veja a seguir a lista de objetos que têm membros que podem ser atualizados.

Objeto Membros
NTMS_CHANGER szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_CHANGER_TYPE szDescription Requer NTMS_MODIFY_ACCESS para o computador.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Requer NTMS_MODIFY_ACCESS para o computador.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_DRIVE_TYPE szDescription Requer NTMS_MODIFY_ACCESS para o computador.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_IEPORT MaxExtendSecs
 
szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_LIBRARY AutoRecovery
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
Szname Requer NTMS_CONTROL_ACCESS para a biblioteca.
NTMS_LIBREQUEST szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_LOGICAL_MEDIA szDescription
 
Szname Requer NTMS_MODIFY_ACCESS ao pool de mídia da mídia lógica.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
Mediatype
 
szDescription
 
Szname Requer NTMS_MODIFY_ACCESS para o pool de mídia.

Windows XP: Requer NTMS_CONTROL_ACCESS para o pool de mídia.
NTMS_MEDIA_TYPE szDescription Requer NTMS_MODIFY_ACCESS para o computador.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQUEST szDescription Requer NTMS_MODIFY_ACCESS para o computador.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_PARTITION szName
 
szDescription Requer NTMS_MODIFY_ACCESS ao pool de mídia do lado.

Windows XP: Requer NTMS_CONTROL_ACCESS para o pool de mídia do lado.
NTMS_PHYSICAL_MEDIA szDescription
 
Szname Requer NTMS_MODIFY_ACCESS ao pool de mídia.

Windows XP: Nenhum direito de acesso é necessário.
NTMS_STORAGESLOT szDescription Requer NTMS_MODIFY_ACCESS à biblioteca.

Windows XP: Nenhum direito de acesso é necessário.
 

Observação

O cabeçalho ntmsapi.h define SetNtmsObjectInformation 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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funções de gerenciamento de objetos