METODE IMFSensorDevice::GetSymbolicLink (mfidl.h)

Artikel
08/24/2023

Mendapatkan nama tautan simbolis perangkat sensor.

Sintaks

HRESULT GetSymbolicLink(
  [out] LPWSTR SymbolicLink,
  [in]  LONG   cchSymbolicLink,
  [out] LONG   *pcchWritten
);

Parameter

[out] SymbolicLink

Buffer karakter cchSymbolicLink tempat nama tautan simbolis akan ditulis. Buffer harus cukup besar untuk memperkirakan terminator null.

[in] cchSymbolicLink

Jumlah karakter yang tersedia dalam buffer SymbolicLink .

[out] pcchWritten

Parameter output yang berisi jumlah karakter yang ditulis ke SymbolicLink. Ini termasuk terminator null. Jika SymbolicLink null dan cchSymbolicLink adalah 0, pcchWritten akan berisi jumlah karakter yang diperlukan (termasuk terminator null) untuk menyimpan nama tautan simbolis.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
ERROR_INSUFFICIENT_BUFFER	Buffer yang disediakan dalam parameter SymbolicLink tidak cukup besar untuk berisi nama tautan simbolis, termasuk terminator null.
MF_E_NOT_INITIALIZED	Perangkat sensor belum diinisialisasi.

Keterangan

Tergantung pada jenis perangkat, yang ditentukan oleh anggota enumerasi MFSensorDeviceType dan dapat diperoleh dengan memanggil GetDeviceType, nama simbolis yang dihasilkan mungkin merupakan nama simbolis perangkat yang valid atau URL penyedia. Pemanggil tidak boleh mencoba mengurai nama dan harus memperlakukannya sebagai data buram.

Persyaratan


Klien minimum yang didukung	Windows 10, versi 1607 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfplat.lib; Mfplat.dll

Lihat juga

IMFSensorDevice

Bagikan melalui