DdeClient.StartAdvise Method (String, Int32, Boolean, Boolean, Int32, Object)
From NDde
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