IMFSensorDevice：：GetSymbolicLink 方法 (mfidl.h)

取得感應器裝置的符號連結名稱。

語法

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

[out] SymbolicLink

將寫入符號連結名稱之 cchSymbolicLink 字元的緩衝區。緩衝區必須夠大，才能考慮 Null 結束字元。

[in] cchSymbolicLink

符號連結緩衝區中可用的字元數。

[out] pcchWritten

輸出參數，其中包含寫入 至 SymbolicLink的字元數。這包括 Null 結束字元。如果 SymbolicLink 為 null 且 cchSymbolicLink 為 0， pcchWritten 將會包含所需的字元數， (包括 null 結束字元) 來儲存符號連結名稱。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
ERROR_INSUFFICIENT_BUFFER	在 SymbolicLink參數中提供的緩衝區不夠大，無法包含符號連結名稱，包括 Null 結束字元。
MF_E_NOT_INITIALIZED	感應器裝置尚未初始化。

根據裝置的類型，由 MFSensorDeviceType 列舉的成員所定義，而且可以藉由呼叫 GetDeviceType來取得，產生的符號名稱可能是有效的裝置符號名稱或提供者 URL。呼叫端不應該嘗試剖析名稱，而且應該將其視為不透明資料。