Compartilhar via


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 mapeou para o caminho da 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 de retorno

Um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

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

Observações

Para receber chamadas remotas de entrada para a interface IAppHostPathMapper2 Interface , o cliente deve fornecer um objeto COM que implemente a IAppHostPathMapper2 interface (COM IID: 0f80e901-8f4c-449a-bf90-13d5d082f187). Em seguida, ele deve especificar um objeto que implemente 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

Tipo 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
Cabeçalho Ahadmin.h

Consulte Também

IAppHostPathMapper2 Interface
IAppHostPathMapper Interface