Função de retorno de chamada CLAIMMEDIALABEL (ntmsmli.h)

  • Artigo

[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 de retorno de chamada ClaimMediaLabel determina se um rótulo de mídia especificado foi criado pelo aplicativo associado da mídia.

Sintaxe

CLAIMMEDIALABEL Claimmedialabel;

DWORD Claimmedialabel(
  [in]  const BYTE * const pBuffer,
  [in]  const DWORD nBufferSize,
  [out] MediaLabelInfo * const pLabelInfo
)
{...}

Parâmetros

[in] pBuffer

Ponteiro para um buffer que contém o rótulo de mídia.

[in] nBufferSize

Tamanho do buffer, em bytes.

[out] pLabelInfo

Ponteiro para uma estrutura MediaLabelInfo . A biblioteca de rótulos de mídia preencherá essa estrutura se a biblioteca reconhecer o rótulo de mídia.

Retornar valor

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

Valor Significado
NO_ERROR
 A biblioteca de rótulos de mídia preenchida na estrutura MediaLabelInfo .
ERROR_BAD_FORMAT
 A biblioteca de rótulos de mídia não reconhece o rótulo de mídia.

Comentários

Quando uma biblioteca de rótulos de mídia usa a função ClaimMediaLabel para identificar o rótulo de mídia como um criado por seu aplicativo associado, a biblioteca de rótulos de mídia deve preencher a estrutura MediaLabelInfo e retornar NO_ERROR. Se a biblioteca de rótulos de mídia não reconhecer o rótulo de mídia, ela retornará ERROR_BAD_FORMAT.

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

Confira também

Funções da Biblioteca de Rótulos de Mídia

MediaLabelInfo