IConnector::Metode GetConnectorIdConnectedTo (devicetopology.h)
Metode GetConnectorIdConnectedTo mendapatkan ID global konektor, jika ada, yang terhubung dengan konektor ini.
Sintaks
HRESULT GetConnectorIdConnectedTo(
[out] LPWSTR *ppwstrConnectorId
);
Parameter
[out] ppwstrConnectorId
Penunjuk ke penunjuk string tempat metode menulis alamat string karakter lebar yang dihentikan null yang berisi ID global konektor lainnya. Metode mengalokasikan penyimpanan untuk string. Pemanggil bertanggung jawab untuk membebaskan penyimpanan, ketika tidak lagi diperlukan, dengan memanggil fungsi CoTaskMemFree . Jika panggilan GetConnectorIdConnectedTo gagal, *ppwstrConnectorId adalah NULL. Untuk informasi tentang CoTaskMemFree, lihat dokumentasi Windows SDK.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Konektor ini tidak tersambung, atau sisi lain koneksi bukan topologi perangkat lain (misalnya, koneksi Software_IO). |
|
Parameter ppwstrConnectorId adalah NULL. |
|
Kehabisan memori. |
Keterangan
ID global adalah string yang secara unik mengidentifikasi bagian di antara semua bagian di semua topologi perangkat dalam sistem. Klien harus memperlakukan string ini sebagai buram. Artinya, klien tidak boleh mencoba mengurai konten string untuk mendapatkan informasi tentang bagian tersebut. Alasannya adalah bahwa format string tidak ditentukan dan mungkin berubah dari satu implementasi API DeviceTopology ke yang berikutnya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | devicetopology.h |