Método IAppHostPathMapper2::MapPath

Obtém os detalhes da decisão de mapeamento específica e, opcionalmente, pode alterar os resultados no valor retornado.

Sintaxe

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

Parâmetros

bstrConfigPath
O caminho da hierarquia que está sendo mapeado.

bstrMappedPhysicalPath
O caminho físico do lado do servidor que o sistema de administração determinou mapeia para o caminho de hierarquia especificado.

pbstrNewPhysicalPath
Defina como o caminho físico novo ou atualizado a ser usado para o mapeamento. Se o mapeamento permanecer o mesmo, o implementador do cliente deverá retornar o caminho físico idêntico que foi passado como bstrMappedPhysicalPath.

phImpersonationToken
Defina como o token de representação que foi usado para acessar o caminho físico.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Descrição
S_OK	Indica que a operação foi bem-sucedida.

Comentários

Para receber chamadas remotas de entrada para a interface interface IAppHostPathMapper2 , o cliente deve implementar um UUID(0f80e901-8f4c-449a-bf90-13d5d082f187). Em seguida, ele deve especificar um objeto que implementa a interface para o método método IAppHostAdminManager::SetMetadata com o valor de bstrMetadataName definido como "pathMapper2".

Como um sistema de administração mapeia caminhos de hierarquia para caminhos físicos no servidor, ele opcionalmente chama o objeto fornecido pelo cliente que implementa a IAppHostPathMapper2 interface. O implementador dessa interface recebe detalhes de todos os mapeamentos e pode alterar os resultados de cada mapeamento, se necessário.

Requisitos

Type	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Produto	- 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
parâmetro	Ahadmin.h

Consulte Também

IAppHostPathMapper2 Interface
IAppHostPathMapper Interface