Função SetNtmsObjectInformationW (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 SetNtmsObjectInformation altera a estrutura de informações do objeto especificado.

Sintaxe

DWORD SetNtmsObjectInformationW(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONW 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.

Valor de retorno

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 tem permissão para o tipo de objeto especificado. Consulte Comentários.
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á 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.

Observações

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

Todas as propriedades graváveis do objeto são lidas da estrutura de NTMS_OBJECTINFORMATION e gravadas no banco de dados sem levar em conta 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 isso, você pode perder as 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: Não são necessários direitos de acesso.
NTMS_CHANGER_TYPE	szDescription requer NTMS_MODIFY_ACCESS para o computador. Windows XP: Não são necessários direitos de acesso.
NTMS_COMPUTER	dwMediaPoolPolicy dwLibRequestFlags dwLibRequestPurgeTime dwOpRequestFlags dwOpRequestPurgeTime szDescription requer NTMS_MODIFY_ACCESS para o computador. Windows XP: Não são necessários direitos de acesso.
NTMS_DRIVE	dwDeferDismountDelay szDescription requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_DRIVE_TYPE	szDescription requer NTMS_MODIFY_ACCESS para o computador. Windows XP: Não são necessários direitos de acesso.
NTMS_IEDOOR	maxopenSecs szDescription requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_IEPORT	MaxExtendSecs szDescription requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_LIBRARY	de Descoberta Automática dwCleanerUsesRemaining dwFlags InventoryMethod szDescription szName requer NTMS_CONTROL_ACCESS à biblioteca.
NTMS_LIBREQUEST	szDescription requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_LOGICAL_MEDIA	szDescription szName requer NTMS_MODIFY_ACCESS ao pool de mídia da mídia lógica. Windows XP: Não são necessários direitos de acesso.
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: Não são necessários direitos de acesso.
NTMS_OPREQUEST	szDescription requer NTMS_MODIFY_ACCESS para o computador. Windows XP: Não são necessários direitos de acesso.
NTMS_PARTITION	szName szDescription requer NTMS_MODIFY_ACCESS para o 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 para o pool de mídia. Windows XP: Não são necessários direitos de acesso.
NTMS_STORAGESLOT	szDescription requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Não são necessários direitos de acesso.

Nota

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

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funções de gerenciamento de objetos

Compartilhar via