DBR701::RequestSync
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
10/16/2008
This method requests up-to-date data for the specified MSN Direct service.
Syntax
int RequestSync(
int applicationType
);
Parameters
applicationType
[in] Specifies the type of MSN Direct service for which you want to request up-to-date data.For a list of possible values, see MSN Direct Service Type Constants.
Return Value
Returns the transaction ID of the request that is sent to the receiver; returns -1 if the request fails.
Remarks
This method prepares the RequestMsgFromHost object by internally creating a message object and arranging a simple request to the MSN Direct receiver for up-to-date data for the specified MSN Direct service, unless the specified service is of type POWER_STATUS and requires a PowerStatusMsg message. If it is a POWER_STATUS request, this method prepares the request by using the data returned from a call to ReadPowerStatusFromApplication in order to verify the current power status of the host device.
This method performs the transaction only if the private NormalProtocolActive variable is set to true. NormalProtocolActive is internally set to true only when a successful connection has been established and no errors are currently being received through the serial port. Therefore, this request will be honored if the communication is currently active and error-free.
Requirements
| Header | DBR701.h |
| Library | DBRLib.lib |
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |
See Also
Reference
DBR701::SendRequestSync
DBR701 Class
MSN Direct Services Classes