Share via

Método IDeviceSpecificProperty::SetValue (devicetopology.h)

  • Artigo

O método SetValue define o valor da propriedade específica do dispositivo.

Sintaxe

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Parâmetros

[in] pvValue

Ponteiro para o novo valor da propriedade específica do dispositivo.

[in] cbValue

O tamanho em bytes do valor da propriedade específica do dispositivo.

[in] pguidEventContext

Valor de contexto para o método IControlChangeNotify::OnNotify . Esse parâmetro aponta para um GUID de contexto de evento. Se a chamada SetValue alterar o estado do controle, todos os clientes que registraram interfaces IControlChangeNotify com esse controle receberão notificações. Em sua implementação do método OnNotify , um cliente pode inspecionar o GUID de contexto de evento para descobrir se ele ou outro cliente é a origem do evento control-change. Se o chamador fornecer um ponteiro NULL para esse parâmetro, o método de notificação do cliente receberá um ponteiro de contexto NULL .

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
 O ponteiro pvValue é NULL.
E_INVALIDARG
 O parâmetro cbValue não corresponde ao tamanho necessário do valor da propriedade.
E_OUTOFMEMORY
 Sem memória.

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

Confira também

IDeviceSpecificProperty Interface