FPCVendorParametersSet.WaitForChanges Method

Registers to wait for an event indicating that the contents of the FPCVendorParametersSet object have changed.

Note  This method can only be used in C and C++ programming languages. It cannot be used with DCOM.

C++ Syntax[C++]

HRESULT WaitForChanges(
  DWORD hEvent
);

Parameters

hEvent

An event that will be signaled whenever the storage content of the FPCVendorParametersSet object has changed.

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.

It is possible to use Visual Basic to get notification of storage changes in the FPCVendorParametersSet object without using the WaitForChanges method, as shown in the following Visual Basic example. This approach will not work in scripting languages.

private sub objectname_OnChange
end sub
'In this example, code executes when the 
'FPCVendorParametersSet object defined as pd changes
Dim FPC As New FPC
Dim WithEvents pd As FPCVendorParametersSet
Private Sub Start_Click()
  Set pd = FPC.Arrays(1).VendorParametersSets(1)
  
End Sub
 
Private Sub pd_OnChange()
  pd.Refresh
  MsgBox "pd_OnChange - user is:" & pd("UserName")
End Sub

Applies To

FPCVendorParametersSet