获取特定映射决策的详细信息,并且可以根据需要更改返回值中的结果。
语法
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 |