Método IDeviceSpecificProperty::SetValue (devicetopology.h)
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 |
---|---|
|
O ponteiro pvValue é NULL. |
|
O parâmetro cbValue não corresponde ao tamanho necessário do valor da propriedade. |
|
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 |