This begins an asynchronous operation to initiate an advise loop on the specified item name.
public virtual IAsyncResult BeginStartAdvise(
String item,
Int32 format,
Boolean hot,
Boolean acknowledge,
AsyncCallback callback,
Object asyncState,
Object adviseState
);
String item,
Int32 format,
Boolean hot,
Boolean acknowledge,
AsyncCallback callback,
Object asyncState,
Object adviseState
);
Parameters
- item
- An item name supported by the current conversation.
- format
- The format of the data to be returned.
- 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.
- callback
- The delegate to invoke when this operation completes.
- asyncState
- An application defined data object to associate with this operation.
- adviseState
- An application defined data object to associate with this advise loop.
Return Value
An IAsyncResult object for this operation.
Events
| Event Type | Reason |
|---|---|
| Advise |
Exceptions
| Exception Type | Condition |
|---|---|
| ArgumentException | This is thown when item exceeds 255 characters. |
| 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 asynchronous operation could not begin. |
See Also
DdeClient Class | NDde.Client Namespace | DdeClient.BeginStartAdvise Overload List