Compartir a través de

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

  • Artículo

El método GetConnectorIdConnectedTo obtiene el identificador global del conector, si existe, al que está conectado este conector.

Sintaxis

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Parámetros

[out] ppwstrConnectorId

Puntero a un puntero de cadena en el que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que contiene el identificador global del otro conector. El método asigna el almacenamiento para la cadena. El autor de la llamada es responsable de liberar el almacenamiento, cuando ya no es necesario, llamando a la función CoTaskMemFree . Si se produce un error en la llamada a GetConnectorIdConnectedTo , *ppwstrConnectorId es NULL. Para obtener información sobre CoTaskMemFree, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_NOTFOUND
 Este conector no está conectado o el otro lado de la conexión no es otra topología de dispositivo (por ejemplo, una conexión Software_IO).
E_POINTER
 El parámetro ppwstrConnectorId es NULL.
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

Un identificador global es una cadena que identifica de forma única una parte entre todas las partes de todas las topologías de dispositivo del sistema. Los clientes deben tratar esta cadena como opaca. Es decir, los clientes no deben intentar analizar el contenido de la cadena para obtener información sobre la parte. El motivo es que el formato de cadena no está definido y podría cambiar de una implementación de la API DeviceTopology a la siguiente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IConnector (Interfaz)