IAppHostPathMapper2::MapPath 方法

获取特定映射决策的详细信息,并且可以根据需要更改返回值中的结果。

语法

HRESULT MapPath(  
   [in, string] BSTR bstrConfigPath,  
   [in, string] BSTR bstrMappedPhysicalPath,  
   [out, string, retval] BSTR * pbstrNewPhysicalPath,  
   [out] HANDLE * phImpersonationToken  
);  

parameters

bstrConfigPath
要映射的层次结构路径。

bstrMappedPhysicalPath
管理系统确定的服务器端物理路径映射到指定的层次结构路径。

pbstrNewPhysicalPath
将 设置为要用于映射的新或更新的物理路径。 如果映射保持不变,则客户端实现者应返回作为 bstrMappedPhysicalPath传入的相同物理路径。

phImpersonationToken
设置为用于访问物理路径的模拟令牌。

返回值

HRESULT。 可能的值包括(但并不限于)下表中的项。

说明
S_OK 指示操作成功。

备注

若要接收 IAppHostPathMapper2 接口 的传入远程调用,客户端必须实现 UUID (0f80e901-8f4c-449a-bf90-13d5d082f187) 。 然后,它必须指定一个对象,该对象实现 IAppHostAdminManager::SetMetadata 方法 方法的接口,其值 bstrMetadataName 设置为“pathMapper2”。

当管理系统将层次结构路径映射到服务器上的物理路径时,它可选择调用实现 IAppHostPathMapper2 接口的客户端提供的对象。 此接口的实现者接收所有映射的详细信息,并可以根据需要更改每个映射的结果。

要求

类型 说明
客户端 - 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
Header Ahadmin.h

另请参阅

IAppHostPathMapper2 接口
IAppHostPathMapper 接口