Método IWMDMDevice3::SetProperty (mswmdm.h)

Artigo
02/29/2024

O método SetProperty define uma propriedade de dispositivo específica, se for gravável.

Sintaxe

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Parâmetros

[in] pwszPropName

Um caractere largo, nome de cadeia de caracteres terminada em nulo da propriedade a ser definida. Isso substitui qualquer propriedade existente com o mesmo nome. Depois que o aplicativo tiver feito essa chamada, ele deverá liberar qualquer memória dinâmica usando PropVariantClear. Uma lista de constantes de nome de propriedade padrão é fornecida em Constantes de Metadados.

[in] pValue

Valor da propriedade que está sendo definida.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método define a propriedade do dispositivo especificada. Para obter a lista de propriedades de dispositivo com suporte, o cliente deve consultar o método IWMDMDevice3::GetProperty para a propriedade g_wszWMDMSupportedDeviceProperties .

Para obter a lista de nomes de propriedade do dispositivo, consulte Constantes de metadados.

Esse método é semelhante ao método SetMetadata para armazenamentos, mas esse método pode definir apenas uma propriedade ao mesmo tempo.

Nem todas as propriedades do dispositivo podem ser definidas.