Compartilhar via


Método IConnector::ConnectTo (devicetopology.h)

O método ConnectTo conecta esse conector a um conector em outro objeto de topologia de dispositivo.

Sintaxe

HRESULT ConnectTo(
  [in] IConnector *pConnectTo
);

Parâmetros

[in] pConnectTo

O outro conector. Esse parâmetro aponta para a interface IConnector do objeto do conector que representa o conector na outra topologia do dispositivo. O chamador é responsável por liberar sua referência contada para a interface IConnector quando ela não é mais necessária. O método ConnectTo obtém sua própria referência a essa interface.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
O ponteiro pConnectTo é NULL.
E_INVALIDARG
O conector atual e o conector remoto apontados pelo pConnectTo têm a mesma direção do fluxo de dados. Um conector com a direção de fluxo de dados "In" deve estar conectado a outro conector com a direção de fluxo de dados "Out" para criar uma conexão válida na topologia. Para determinar o fluxo de dados de um conector, chame IConnector::GetDataFlow.
E_NOINTERFACE
O objeto apontado por pConnectTo não é um objeto de conector válido.
HRESULT_FROM_WIN32(ERROR_DEVICE_ALREADY_ATTACHED)
Um dos dois conectores já está anexado a outro conector. Para obter informações sobre essa macro, consulte a documentação do SDK do Windows.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IConnector Interface