ICcTransport::CreateStream (Windows Embedded CE 6.0)

1/5/2010

This method creates a stream based on a stream ID for the given transport.

Syntax

HRESULT CreateStream(
  LPCOLESTR wszStreamId,
  DWORD dwTimeout,
  VARIANT_BOOL bAsync,
  ICcTransportStream** piStream
);

Parameters

• wszStreamId
  [in] The stream ID in the form of a string that identifies the stream.

  If equal to L"", an ID is generated that can be retrieved from ICcTransportStream::ID.

  If not equal to L"", wszStreamId follows the transport-specific convention. For example, KITL is a string 16 characters long or less, and TCP is an IP address and port.

• dwTimeout
  [in] Timeout in milliseconds for stream creation to complete.

  If the bAsync value is set to VARIANT_FALSE, and if the stream is not created within the specified timeout, this method returns failure.

  If the bAsync value is set to VARIANT_TRUE, this parameter is ignored.

• bAsync
  [in] Indicator for asynchronous stream creation call.

  If this is set to VARIANT_TRUE, the method returns immediately and the caller is informed when the stream is created via callback interfaces ICcServiceCB.

  If this is set to VARIANT_FALSE, the method blocks for dwTimeout waiting for the stream to be created.

• piStream
  [out, retval] Pointer to the ICcTransportStream object.

  The stream object can be used to send raw bytes and to receive the byte stream from the device.

Return Value

The following table shows return values for this method.

Remarks

The stream IDs of the associated desktop and device establishing the connection streams must match.

Requirements

See Also

Reference

ICcTransport
Core Connectivity Interfaces