Метод IAppHostPathMapper2::MapPath

Возвращает сведения о конкретном решении сопоставления и, при необходимости, может изменить результаты в возвращаемом значении.

Синтаксис

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 , клиент должен предоставить COM-объект, реализующий IAppHostPathMapper2 интерфейс (COM IID: 0f80e901-8f4c-449a-bf90-13d5d082f187). Затем необходимо указать объект, реализующий интерфейс для метода метода IAppHostAdminManager::SetMetadata Method со значением bstrMetadataName pathMapper2.

Как система администрирования сопоставляет пути иерархии с физическими путями на сервере, он при необходимости вызывает предоставленный клиентом объект, реализующий IAppHostPathMapper2 интерфейс. Реализация этого интерфейса получает сведения обо всех сопоставлениях и может изменять результаты каждого сопоставления при необходимости.

Требования

Тип Описание
Client — IIS 7.0 в Windows Vista
— IIS 7.5 на Windows 7
— IIS 8.0 в Windows 8
— IIS 10.0 в Windows 10
Сервер — IIS 7.0 в Windows Server 2008 г.
— IIS 7.5 на Windows Server 2008 R2
— IIS 8.0 в Windows Server 2012
— IIS 8.5 на Windows Server 2012 R2
— IIS 10.0 в Windows Server 2016
Товар — 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