共用方式為

MonikerRelativePathTo 函式 (objbase.h)

  • 發行項

提供Moniker，當撰寫到第一個指定的Moniker結尾 (或具有類似結構) 的Moniker時，會產生第二個指定的Moniker。

此函式僅供 IMoniker：：RelativePathTo 實作使用。

語法

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

參數

[in] pmkSrc

Moniker 上 IMoniker 介面的指標，當以要建立的相對 Moniker 撰寫時，會產生 pmkDest。 此 Moniker 會識別要建立之相對 Moniker 的「來源」。

[in] pmkDest

要相對於 pmkSrc 表示之 Moniker 上 IMoniker 介面的指標。 此 Moniker 會識別要建立之相對 Moniker 的目的地。

[out] ppmkRelPath

接收新相對Moniker介面指標的 IMoniker* 指標變數位址。 成功時，函式已在Moniker上呼叫 AddRef ，而呼叫端負責呼叫 Release。 如果發生錯誤，介面指標值為 NULL。

[in] dwReserved

此參數是保留的，而且必須是非零。

傳回值

此函式可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

傳回碼 描述
S_OK
 已傳回有意義的相對路徑。
MK_S_HIM
 相對路徑的唯一形式是另一個Moniker。
MK_E_NOTBINDABLE
 pmkSrc 參數是相對Moniker，例如專案Moniker，而且必須以其容器的Moniker組成，才能判斷相對路徑。

備註

IMoniker：：RelativePathTo 的實作應該先檢查另一個Moniker是否為您以特殊方式辨識和處理的類型。 如果沒有，您應該呼叫 MonikerRelativePathTo，將本身傳遞為 pmkThis ，並將另一個Moniker傳遞為 pmkOther。 MonikerRelativePathTo 可正確處理Moniker 是泛型複合的案例。

只有當 pmkSrc 和 pmkDest 都是絕對 Moniker 時，才應該呼叫此函式，其中絕對 Moniker 是檔案 Moniker 或最左邊元件為檔案 Moniker 的泛型複合，以及檔案 Moniker 代表絕對路徑的位置。 請勿在相對Moniker上呼叫此函式。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objbase.h
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

IMoniker：：RelativePathTo