IFPCVendorParametersSet::WaitForChanges method

Article
08/27/2012

Applies to: desktop apps only

The WaitForChanges method registers to wait for an event indicating that the contents of the object have changed.

Syntax

HRESULT WaitForChanges(
  [in]  HANDLE_PTR hEvent
);

Parameters

hEvent [in]
An event that will be signaled whenever the contents of the FPCVendorParametersSet object change.

Return value

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This method allows application filters to handle dynamic configuration changes smoothly. Note that when you develop an application filter that uses the WaitForChanges method to handle dynamic changes, the FPCVendorParametersSet object should be preserved as long as is necessary to receive notifications. This can be done by making the FPCVendorParametersSet object a member of the filter (IFWXFilter) object.

This method can only be used in C and C++ programming languages. Also, it cannot be used with DCOM.

It is possible to use Visual Basic to get notification of storage changes in the FPCVendorParametersSet object without using the WaitForChanges method. For more information, see the Remarks section in the FPCVendorParametersSet topic.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll