Função UpdateNtmsOmidInfo (ntmsapi.h)

[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 UpdateNtmsOmidInfo atualiza o banco de dados RSM com informações de rótulo imediatamente após a gravação no meio recém-alocado.

Sintaxe

DWORD UpdateNtmsOmidInfo(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       labelType,
  [in] DWORD       numberOfBytes,
  [in] LPVOID      lpBuffer
);

Parâmetros

[in] hSession

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

[in] lpMediaId

Identificador exclusivo de uma parte da mídia lógica.

[in] labelType

Tipo de rótulo. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
NTMS_OMID_TYPE_FILESYSTEM_INFO	O parâmetro lpBuffer contém uma estrutura NTMS_FILESYSTEM_INFO. Esse sinalizador é usado para mídia que contém sistemas de arquivos.
NTMS_OMID_TYPE_RAW_LABEL	O parâmetro lpBuffer contém os bytes brutos do rótulo do aplicativo. Esse sinalizador é usado para mídia que contém rótulos escritos pelo aplicativo.

[in] numberOfBytes

Número de bytes enviados no parâmetro lpBuffer .

[in] lpBuffer

Informações de rótulo. O formato desse parâmetro depende do valor do parâmetro labelType .

Retornar valor

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

Valor	Significado
ERROR_ACCESS_DENIED	O acesso a um ou mais objetos RSM é negado.
ERROR_DATABASE_FAILURE	Falha na consulta ou atualização do banco de dados.
ERROR_INVALID_HANDLE	O valor especificado no parâmetro hSession não é válido.
ERROR_INVALID_MEDIA	Não é possível recuperar a definição de mídia lógica do banco de dados.
ERROR_INVALID_PARTITION	Não é possível recuperar a definição lateral do banco de dados.
ERROR_INVALID_PARAMETER	O parâmetro lpMediaId é NULL.
ERROR_NOT_CONNECTED	Não é possível se conectar ao serviço RSM.
ERROR_SUCCESS	A função foi bem-sucedida.

Comentários

O aplicativo atualiza o RSM com as informações fornecidas pela função UpdateNtmsOmidInfo e o RSM verifica as informações no banco de dados. As informações de rótulo são armazenadas no banco de dados RSM com o lado associado a esse LMID.

A função UpdateNtmsOmidInfo deve ser executada no servidor RSM. A execução remota dessa função resulta em um erro.

Para a mídia de fita lpBuffer deve apontar para um buffer que contém o rótulo gravado na fita. Os dados nesse buffer são passados diretamente para o ponto de entrada ClaimMediaLabel de cada MLL. Uma das MLLs instaladas deve reconhecer um rótulo válido nesses dados.

Para mídia com sistemas de arquivos, lpBuffer deve ser um ponteiro para um buffer que contenha a seguinte estrutura:

typedef struct {
    WCHAR   FileSystemType[64];
    WCHAR   VolumeName[256];
    DWORD   SerialNumber;
} NTMS_FILESYSTEM_INFO;

O RSM usa essas informações do sistema de arquivos como o OMID. Os utilitários de formato (LDM, explorer, format.com e assim por diante) executam efetivamente a mesma funcionalidade que essa chamada. Um aplicativo que executa sua própria formatação ou formatos com um tipo de sistema de arquivos de terceiros só deve precisar chamar UpdateNtmsOmidInfo para mídia do sistema de arquivos.

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

Funções de gerenciamento de identificador de mídia