This initiates an advise loop on the specified item name.
public virtual void StartAdvise(
String item,
Int32 format,
Boolean hot,
Boolean acknowledge,
Int32 timeout,
Object adviseState
);
String item,
Int32 format,
Boolean hot,
Boolean acknowledge,
Int32 timeout,
Object adviseState
);
Parameters
- item
- An item name supported by the current conversation.
- format
- The format of the data to return.
- hot
- A bool indicating whether data should be included with the notification.
- acknowledge
- A bool indicating whether the client should acknowledge each advisory before the server will send send another.
- timeout
- The amount of time in milliseconds to wait for a response.
- adviseState
- An application defined data object to associate with this advise loop.
Remarks
This operation will timeout if the conversation is paused.
Events
| Event Type | Reason |
|---|---|
| Advise |
Exceptions
| Exception Type | Condition |
|---|---|
| ArgumentException | This is thown when item exceeds 255 characters or timeout is negative. |
| ArgumentNullException | This is thrown when item is a null reference. |
| InvalidOperationException | This is thrown when the item is already being advised or when the client is not connected. |
| DdeException | This is thrown when the server does not initiate the advise loop. |
See Also
DdeClient Class | NDde.Client Namespace | DdeClient.StartAdvise Overload List