Compartilhar via

Método IWSDDeviceHost::SetMetadata (wsdhost.h)

  • Artigo

Define os metadados de um dispositivo, excluindo metadados de serviço definidos pelo usuário.

Sintaxe

HRESULT SetMetadata(
  [in]           const WSD_THIS_MODEL_METADATA   *pThisModelMetadata,
  [in]           const WSD_THIS_DEVICE_METADATA  *pThisDeviceMetadata,
  [in, optional] const WSD_HOST_METADATA         *pHostMetadata,
  [in, optional] const WSD_METADATA_SECTION_LIST *pCustomMetadata
);

Parâmetros

[in] pThisModelMetadata

Referência a uma estrutura WSD_THIS_MODEL_METADATA que especifica metadados comuns a todas as instâncias do modelo deste dispositivo. Os membros Manufacturer, ModelNames e ModelNumber da estrutura devem conter entradas não NULL e não em branco.

[in] pThisDeviceMetadata

Referência a uma estrutura de WSD_THIS_DEVICE_METADATA que especifica metadados exclusivos para este dispositivo. Os membros FriendlyName, FirmwareVersion e SerialNumber dessa estrutura devem conter entradas não NULL e não em branco.

[in, optional] pHostMetadata

Referência a uma estrutura WSD_HOST_METADATA que especifica metadados de host de serviço, que os dados e características específicos do dispositivo (por exemplo, uma impressora dá suporte à cor ou tem um grampeador).

[in, optional] pCustomMetadata

Referência a uma estrutura de WSD_METADATA_SECTION_LIST que especifica metadados personalizados adicionais associados a esse dispositivo.

Retornar valor

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte:

Código de retorno Descrição
S_OK
 Método concluído com êxito.
E_INVALIDARG
 pThisDeviceMetadata é NULL, pThisModelMetadata é NULL ou qualquer estrutura não contém os membros necessários. Consulte as descrições de parâmetro para obter uma lista de membros necessários.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.

Comentários

Esse método deve ser chamado pelo menos uma vez antes de iniciar qualquer host de dispositivo registrado no RegisterService. Ele pode ser chamado depois que o dispositivo é iniciado para atualizar os metadados, nesse caso, WS-Discovery mensagens hello são emitidas indicando a nova versão de metadados.

Nota O recurso de atualização ainda não foi implementado.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wsdhost.h (inclua Wsdapi.h)
DLL Wsdapi.dll

Confira também

Iwsddevicehost