IHttpServer2::GetExtendedInterface-Methode

Ruft den korrekten abwärts umgewandelten Zeiger basierend auf Den Werten der Versions-GUID (globally unique identifier) ab.

Syntax

virtual HRESULT GetExtendedInterface(  
   _In_ const GUID &       Version1,  
   _In_ PVOID              pInput,  
   _In_ const GUID &       Version2,  
   _Outptr_ PVOID *        ppOutput  
) = 0;  

Parameter

Version1
[IN] GUID der Legacy-instance.

pInput
[IN] Verweist auf die Legacy-instance.

Version2
[IN] GUID der Schnittstelle, die in umgewandelt werden soll.

ppOutput
[OUT] Zeigt auf die downumwanderte instance.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	BESCHREIBUNG
S_OK	Gibt an, dass der Vorgang erfolgreich war.

Bemerkungen

Diese Methode ist für die Umwandlung eines Basisklassenzeigers auf eine abgeleitete Klasse vorgesehen. Angenommen, Sie verfügen über einen vorhandenen instance Zeiger auf IHttpRequest. Ihr Code müsste in die abgeleitete Klasse IHttpRequest2 umgewandelt werden, um eine der neuen Methoden aufrufen zu können.

HRESULT SomeFunction(   
    IHttpServer2* pHttpServer,  
    IHttpRequest pHttpRequest   
)  
{  
    IHttpRequest2 pHttpRequest2 = NULL;  
    // Grab a new interface!  
    pHttpServer-> GetExtendedInterface(__uuidof(pHttpRequest), pHttpRequest, __uuidof(pHttpRequest2), &pHttpRequest2 );  
    …  
}  

Anstatt zu verwenden GetExtendedInterface, können Sie die HttpGetExtendedInterface-Hilfsprogrammfunktion des Clients verwenden, um den Zeiger nach unten zu umwandeln.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016
Produkt	– 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	Httpserv.h

Weitere Informationen

IHttpServer2-Schnittstelle