Método IUPnPEventSink::OnStateChanged (upnphost.h)

  • Artigo

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

Confira também

IUPnPEventSink