IConnector::GetConnectorIdConnectedTo メソッド (devicetopology.h)

  • [アーティクル]

GetConnectorIdConnectedTo メソッドは、このコネクタが接続されているコネクタのグローバル ID (存在する場合) を取得します。

構文

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

パラメーター

[out] ppwstrConnectorId

メソッドが、他のコネクタのグローバル ID を含む null で終わるワイド文字列のアドレスを書き込む文字列ポインターへのポインター。 メソッドは、文字列のストレージを割り当てます。 呼び出し元は、不要になったときに CoTaskMemFree 関数を呼び出すことによって、ストレージを解放する役割を担います。 GetConnectorIdConnectedTo 呼び出しが失敗した場合、*ppwstrConnectorId は NULL です。 CoTaskMemFree の詳細については、Windows SDK のドキュメントを参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
E_NOTFOUND
 このコネクタが接続されていないか、接続の反対側が別のデバイス トポロジ (たとえば、Software_IO接続) ではありません。
E_POINTER
 パラメーター ppwstrConnectorId が NULL です。
E_OUTOFMEMORY
 メモリが不足しています。

注釈

グローバル ID は、システム内のすべてのデバイス トポロジ内のすべての部分の一部を一意に識別する文字列です。 クライアントは、この文字列を不透明として扱う必要があります。 つまり、クライアントは文字列の内容を解析して部分に関する情報を取得しようとしないでください。 その理由は、文字列形式が未定義であり、DeviceTopology API の実装から次の実装に変更される可能性があるためです。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IConnector インターフェイス