IAppHostPathMapper2::MapPath-Methode

Ruft die Details der spezifischen Zuordnungsentscheidung ab und kann optional die Ergebnisse im Rückgabewert ändern.

Syntax

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

Parameter

bstrConfigPath
Der Hierarchiepfad, der zugeordnet wird.

bstrMappedPhysicalPath
Der serverseitige physische Pfad, den das Verwaltungssystem bestimmt hat, ist dem angegebenen Hierarchiepfad zugeordnet.

pbstrNewPhysicalPath
Legen Sie den neuen oder aktualisierten physischen Pfad fest, der für die Zuordnung verwendet werden soll. Wenn die Zuordnung gleich bleibt, sollte der Clientimplementierer den identischen physischen Pfad zurückgeben, der als übergeben bstrMappedPhysicalPathwurde.

phImpersonationToken
Legen Sie diesen Wert auf das Identitätswechseltoken fest, das für den Zugriff auf den physischen Pfad verwendet wurde.

Rückgabewert

Ein HRESULT-Element. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

Um eingehende Remoteaufrufe für die IAppHostPathMapper2-Schnittstelle zu empfangen, muss der Client ein COM-Objekt bereitstellen, das die IAppHostPathMapper2 Schnittstelle implementiert (COM IID: 0f80e901-8f4c-449a-bf90-13d5d082f187). Anschließend muss ein Objekt angegeben werden, das die Schnittstelle zur IAppHostAdminManager::SetMetadata-Methode implementiert, wobei der Wert bstrMetadataName auf "pathMapper2" festgelegt ist.

Da ein Verwaltungssystem Hierarchiepfade physischen Pfaden auf dem Server zuordnet, ruft es optional das vom Client bereitgestellte Objekt auf, das die IAppHostPathMapper2 Schnittstelle implementiert. Der Implementierer dieser Schnittstelle empfängt Details aller Zuordnungen und kann die Ergebnisse jeder Zuordnung bei Bedarf ändern.

Anforderungen

Siehe auch

IAppHostPathMapper2-Schnittstelle
IAppHostPathMapper-Schnittstelle