取得特定對應決策的詳細資料，並選擇性地變更傳回值的結果。
語法
HRESULT MapPath(
[in, string] BSTR bstrConfigPath,
[in, string] BSTR bstrMappedPhysicalPath,
[out, string, retval] BSTR * pbstrNewPhysicalPath,
[out] HANDLE * phImpersonationToken
);
參數
bstrConfigPath
要對應的階層路徑。
bstrMappedPhysicalPath
系統判定的伺服器端實體路徑會對應至指定的階層路徑。
pbstrNewPhysicalPath
設定為要用於對應的新或更新實體路徑。 如果對應維持不變，用戶端實作者應該傳回與 bstrMappedPhysicalPath 傳入相同的實體路徑。
phImpersonationToken
設定為用來存取實體路徑的模擬權杖。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
備註
若要接收 IAppHostPathMapper2 介面 介面的傳入遠端呼叫，用戶端必須實作 UUID (0f80e901-8f4c-449a-bf90-13d5d082f187) 。 然後，它必須指定物件，以實作 IAppHostAdminManager：：SetMetadata 方法 方法的 介面，並將 值 bstrMetadataName 設定為 「pathMapper2」。
當系統將階層路徑對應至伺服器上的實體路徑時，它會選擇性地呼叫實作 IAppHostPathMapper2 介面的用戶端提供物件。 此介面的實作者會接收所有對應的詳細資料，並視需要變更每個對應的結果。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| 標頭 | Ahadmin.h |