ICcServer::GetConnection (Windows Embedded CE 6.0)

1/5/2010

This method returns a pointer to the ICcConnection object for a specified target device.

In Windows Embedded CE 6.0, CoreCon HLAPI has been deprecated.

Syntax

HRESULT GetConnection(
  ICcDevice* piDevice,
  DWORD dwTimeout,
  ICcServiceCB* piCallback,
  BSTR* pbstrConnectionId,
  ICcConnection** piTargetDevice
);

Parameters

• piDevice
  [in] A pointer to a valid ICcDevice that identifies the device to connect. This is normally retrieved from the datastore.

• dwTimeout
  [in] Timeout in milliseconds for connect to complete if piCallback value is set to NULL.

  If the connection is not created within the specified timeout, the method returns failure.

  If piCallback value is set to non-NULL, this parameter is ignored.

• piCallback
  [in] Pointer to the callback interface passed in by the clients.

  If this is a valid pointer, the method returns immediately and the caller is informed when the connection is created via callback interfaces ICcServiceCB.

  If this is NULL, the method blocks for dwTimeout milliseconds waiting for connection to be created.

• pbstrConnectionId
  [out] Pointer to a connection ID that can be used to identify this connection.

• piTargetDevice
  [out, retval] Out parameter pointing to the ICcConnection object.

  This is NULL if there is a failure, or if the call is an asynchronous call.

Return Value

If the method fails, it returns an HRESULT error code. Otherwise, the method returns one of the following values.

Remarks

To establish a connection, the user must call ICcConnection::ConnectDevice.

Requirements

See Also

Reference

ICcServer
Core Connectivity Interfaces