IMoniker：：CommonPrefixWith 方法 (objidl.h)

發行項
02/29/2024

根據這個Moniker與指定Moniker共通的前置詞，建立新的Moniker。

語法

HRESULT CommonPrefixWith(
  [in]  IMoniker *pmkOther,
  [out] IMoniker **ppmkPrefix
);

參數

[in] pmkOther

要與這個Moniker比較的另一個Moniker介面上 IMoniker 介面的指標，以判斷是否有通用前置詞。

[out] ppmkPrefix

IMoniker* 指標變數的位址，該變數會接收此 Moniker 和 pmkOther 常見前置詞的 Moniker 介面指標。成功時，實作必須在產生的Moniker上呼叫 AddRef ;呼叫者必須負責呼叫 Release。如果發生錯誤或沒有常見的前置詞，實作應該將 *ppmkPrefix 設定為 NULL。

傳回值

這個方法可以傳回標準傳回值E_OUTOFMEMORY，以及下列值。

傳回碼	描述
S_OK	常見的前置詞不存在於此 Moniker 或 pmkOther。
MK_S_NOPREFIX	沒有常見的前置詞存在。
MK_S_HIM	整個 pmkOther 是這個 Moniker 的前置詞。
MK_S_US	這兩個Moniker完全相同。
MK_S_ME	此 Moniker 是 pmkOther moniker 的前置詞。
MK_S_NOTBINDABLE	這個方法是在相對Moniker上呼叫。在相對Moniker上採用通用前置詞並不有意義。

備註

CommonPrefixWith 會 建立新的 Moniker，其中包含這個 Moniker 物件和其他 Moniker 上 Moniker 的通用前置詞。例如，如果一個Moniker代表路徑 c:\projects\secret\art\pict1.bmp c:\projects\secret\docs\chap1.txt”

來電者附註

CommonPrefixWith 方法主要是在 IMoniker：：RelativePathTo 方法的實作中呼叫。使用Moniker尋找物件很少需要呼叫這個方法的用戶端。

只有在 pmkOther 和這個 Moniker 都是絕對 Moniker 時，才呼叫這個方法。絕對Moniker是檔案Moniker或泛型複合，其最左邊的元件是代表絕對路徑的檔案Moniker。請勿在相對Moniker上呼叫這個方法，因為它不會產生有意義的結果。

實作者的注意事項

您的實作應該先判斷 pmkOther 是否為您所辨識類別的 Moniker，例如，如果它與這個 Moniker) 相同，則可以提供特殊處理 (。如果是，您的實作應該判斷兩個Moniker的通用前置詞。否則，它應該在對 MonikerCommonPrefixWith 函式的呼叫中傳遞這兩個Moniker，以正確處理泛型大小寫。

實作特定附注

實作	備註
反Moniker	如果另一個Moniker也是反Moniker，此方法會傳回 MK_S_US，並將 ppmkPrefix 設定為此Moniker。否則，方法會呼叫 MonikerCommonPrefixWith 函式。此函式可正確處理其他Moniker是泛型複合的案例。
類別Moniker	如果 pmkOther 等於這個 Moniker，則擷取這個 Moniker 的指標，並傳回MK_S_US。如果 pmkOther 是類別 Moniker，但不等於這個 Moniker，則會傳回MK_E_NOPREFIX。否則，傳回以 pmkThis、pmkOther 和 ppmkPrefix 的形式呼叫 MonikerCommonPrefixWith 的結果，以處理 pmkOther 是泛型複合 Moniker 的情況。
檔案Moniker	如果兩個Moniker都是檔案Moniker，這個方法會傳回以兩個檔案Moniker開頭的一般元件為基礎的檔案Moniker。檔案 Moniker 的元件可以是下列類型： \\server\share 格式的計算機名稱。計算機名稱會被視為單一元件，因此代表路徑 “\\myserver\public\work” 和 “\\myserver\private\games” 的兩個 Moniker 沒有 “\\myserver” 做為通用前置詞。磁碟驅動器指定 (例如「C：“) 。目錄或檔名。如果另一個Moniker不是檔案Moniker，這個方法會在呼叫 MonikerCommonPrefixWith 函式時傳遞這兩個Moniker。此函式可正確處理其他Moniker是泛型複合的案例。如果沒有常見的前置詞，這個方法會傳回MK_E_NOPREFIX。
泛型複合Moniker	如果另一個Moniker是複合的，這個方法會比較每個複合的元件，從左至右。傳回的通用前置詞 Moniker 也可能是複合 Moniker，視這兩個 Moniker 共通的元件數目而定。如果另一個Moniker不是複合，則方法只會將它與這個Moniker的最左邊元件進行比較。如果Moniker相等，此方法會傳回MK_S_US，並將 ppmkPrefix 設定為這個Moniker。如果另一個 Moniker 是這個 Moniker 的前置詞，此方法會傳回 MK_S_HIM，並將 ppmkPrefix 設定為另一個 Moniker。如果這個Moniker是另一個的前置詞，這個方法會傳回MK_S_ME，並將 ppmkPrefix 設定為這個Moniker。如果沒有常見的前置詞，此方法會傳回 MK_E_NOPREFIX，並將 ppmkPrefix 設定為 NULL。
專案Moniker	如果另一個Moniker是等於這個Moniker的專案Moniker，這個方法會將 *ppmkPrefix 設定為此Moniker，並傳回MK_S_US;否則，方法會呼叫 MonikerCommonPrefixWith 函式。此函式可正確處理其他Moniker是泛型複合的案例。
OBJREF Moniker	如果兩個Moniker相等，此方法會傳回MK_S_US，並將 *ppmkPrefix 設定為 NULL。如果另一個 Moniker 不是 OBJREF Moniker，這個方法會將這兩個 Moniker 傳遞至 MonikerCommonPrefixWith 函式。此函式可正確處理其他Moniker是泛型複合的案例。如果沒有常見的前置詞，這個方法會傳回MK_E_NOPREFIX。
指標 Moniker	如果兩個Moniker相等，這個方法會傳回MK_S_US，並將 *ppmkPrefix 設定為此Moniker。否則，方法會傳回MK_E_NOPREFIX，並將 *ppmkPrefix 設定為 NULL。
URL Moniker	這個方法會傳回E_NOTIMPL。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	objidl.h

另請參閱

IMoniker

MonikerCommonPrefixWith

共用方式為