Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function sends one or more evented variables to all remote subscribers using the UPnP event notification scheme.

Syntax 

BOOL WINAPI UpnpSubmitPropertyEvent(
  PCWSTR 
pszDeviceName,
  PCWSTR 
pszUDN,
  PCWSTR 
pszServiceId,
  DWORD 
nArgs,
  UPNPPARAM* 
rgArgs
);

Parameters

pszDeviceName

[in] Local device name specified in the UPNPDEVICEINFOstructure.

pszUDN

[in] UDN uniquely identifying the device instance.

pszServiceId

[in] Specifies the service identifier for the service from the device description.

nArgs

[in] Specifies the number of elements in an rgArgsarray.

rgArgs

[in] Specifies an array of UPNPPARAMstructures, each specifying the name and value of one variable.

Return Value

Returns TRUE if the function call succeeds, FALSE if an error occurs.

Remarks

This function is typically called from inside the callback function, after fulfilling out a remote request. The variable names and values must conform to the published SCPD. The device is responsible for moderating the frequency of event notifications.

Requirements

Header upnpdevapi.h
Library Upnpcapi.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also