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

O método GetConnectorIdConnectedTo obtém a ID global do conector, se houver, à qual esse conector está conectado.

Sintaxe

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Parâmetros

[out] ppwstrConnectorId

Ponteiro para um ponteiro de cadeia de caracteres no qual o método grava o endereço de uma cadeia de caracteres largos terminada em nulo que contém a ID global do outro conector. O método aloca o armazenamento para a cadeia de caracteres. O chamador é responsável por liberar o armazenamento, quando ele não é mais necessário, chamando a função CoTaskMemFree . Se a chamada GetConnectorIdConnectedTo falhar, *ppwstrConnectorId será NULL. Para obter informações sobre CoTaskMemFree, consulte a documentação do SDK do Windows.

Retornar valor

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_NOTFOUND	Esse conector não está conectado ou o outro lado da conexão não é outra topologia de dispositivo (por exemplo, uma conexão Software_IO).
E_POINTER	O parâmetro ppwstrConnectorId é NULL.
E_OUTOFMEMORY	Sem memória.

Comentários

Uma ID global é uma cadeia de caracteres que identifica exclusivamente uma parte entre todas as partes em todas as topologias de dispositivo no sistema. Os clientes devem tratar essa cadeia de caracteres como opaca. Ou seja, os clientes não devem tentar analisar o conteúdo da cadeia de caracteres para obter informações sobre a parte. O motivo é que o formato de cadeia de caracteres é indefinido e pode mudar de uma implementação da API DeviceTopology para a próxima.

Requisitos

Requisito	Valor
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