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 |
|---|---|
|
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). |
|
O parâmetro ppwstrConnectorId é NULL. |
|
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 |