Método IUPnPEventSink::OnStateChanged (upnphost.h)
O método OnStateChanged envia um evento para o host do dispositivo com a lista de DISPIDs das variáveis de estado que foram alteradas. O host do dispositivo deve consultar o objeto de serviço para obter o novo valor para cada variável de estado que foi alterada.
Esse método não está disponível para desenvolvedores do Visual Basic e aqueles que usam outras linguagens que não dão suporte a matrizes nativas. Em vez disso, esses desenvolvedores devem usar OnStateChangedSafe .
Sintaxe
HRESULT OnStateChanged(
[in] DWORD cChanges,
[in] DISPID [] rgdispidChanges
);
Parâmetros
[in] cChanges
Especifica o número de variáveis em rgdispidChanges. O valor indica o número de variáveis cujos valores foram alterados.
[in] rgdispidChanges
Contém uma lista dos DISPIDs das variáveis de estado que foram alteradas. O número de elementos nesse buffer é especificado por cChanges.
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.
Se cChanges for zero ou rgdispidChanges for NULL, E_INVALIDARG será retornado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnphost.h |
| DLL | Upnphost.dll |