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

Sintaxe

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

Parâmetros

[in] hSession

Identificador 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 tem permissão para o 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á 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.

Comentários

O tamanho e o tipo das 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 a hora em que esse aplicativo chamou a função GetNtmsObjectInformation e a função SetNtmsObjectInformation . Por isso, 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 à biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_CHANGER_TYPE	szDescription Requer NTMS_MODIFY_ACCESS ao computador. Windows XP: Nenhum direito de acesso é necessário.
NTMS_COMPUTER	dwMediaPoolPolicy   dwLibRequestFlags   dwLibRequestPurgeTime   dwOpRequestFlags   dwOpRequestPurgeTime   szDescription Requer NTMS_MODIFY_ACCESS ao computador. Windows XP: Nenhum direito de acesso é necessário.
NTMS_DRIVE	dwDeferDismountDelay   szDescription Requer NTMS_MODIFY_ACCESS à biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_DRIVE_TYPE	szDescription Requer NTMS_MODIFY_ACCESS ao computador. Windows XP: Nenhum direito de acesso é necessário.
NTMS_IEDOOR	MaxOpenSecs   szDescription Requer NTMS_MODIFY_ACCESS à biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_IEPORT	MaxExtendSecs   szDescription Requer NTMS_MODIFY_ACCESS à biblioteca. Windows XP: Nenhum direito de acesso é necessário.
NTMS_LIBRARY	AutoRecuperação   dwCleanerUsesRemaining   dwFlags   InventoryMethod   szDescription   Szname Requer NTMS_CONTROL_ACCESS para a biblioteca.
NTMS_LIBREQUEST	szDescription Requer NTMS_MODIFY_ACCESS à 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 ao pool de mídia. Windows XP: Requer NTMS_CONTROL_ACCESS ao pool de mídia.
NTMS_MEDIA_TYPE	szDescription Requer NTMS_MODIFY_ACCESS ao computador. Windows XP: Nenhum direito de acesso é necessário.
NTMS_OPREQUEST	szDescription Requer NTMS_MODIFY_ACCESS ao computador. Windows XP: Nenhum direito de acesso é necessário.
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: Nenhum direito de acesso é necessário.
NTMS_STORAGESLOT	szDescription Requer NTMS_MODIFY_ACCESS para a biblioteca. Windows XP: Nenhum direito de acesso é necessário.

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