IMFSensorGroup：：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	感測器群組尚未初始化。