Поделиться через

Метод IConnector::GetConnectorIdConnectedTo (devicetopology.h)

  • Статья

Метод GetConnectorIdConnectedTo получает глобальный идентификатор соединителя, если он имеется, к которому подключен этот соединитель.

Синтаксис

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Параметры

[out] ppwstrConnectorId

Указатель на строковый указатель, в который метод записывает адрес завершаемой null строкой расширенных символов, содержащей глобальный идентификатор другого соединителя. Метод выделяет хранилище для строки. Вызывающий объект отвечает за освобождение хранилища, когда оно больше не требуется, путем вызова функции CoTaskMemFree . Если вызов GetConnectorIdConnectedTo завершается сбоем, *ppwstrConnectorOrId имеет значение NULL. Сведения о CoTaskMemFree см. в документации по Windows SDK.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата Описание
E_NOTFOUND
 Этот соединитель не подключен или другая сторона подключения не является другой топологией устройства (например, подключением Software_IO).
E_POINTER
 Параметр ppwstrConnectorId имеет значение NULL.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Глобальный идентификатор — это строка, которая однозначно идентифицирует часть среди всех частей во всех топологиях устройств в системе. Клиенты должны рассматривать эту строку как непрозрачную. То есть клиенты не должны пытаться проанализировать содержимое строки для получения сведений о части. Причина заключается в том, что формат строки не определен и может измениться от одной реализации API DeviceTopology к другой.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

См. также раздел

Интерфейс IConnector