Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Definisce il prototipo di RegisterModule funzione per i moduli HTTP di codice nativo.
Sintassi
typedef HRESULT(WINAPI* PFN_REGISTERMODULE)(
DWORD dwServerVersion,
IHttpModuleRegistrationInfo* pModuleInfo,
IHttpServer* pGlobalInfo
);
Parametri
dwServerVersion
Oggetto DWORD contenente il numero di versione principale di IIS.
pModuleInfo
Puntatore a un'interfaccia IHttpModuleRegistrationInfo .
pGlobalInfo
Puntatore a un'interfaccia IHttpServer .
Valore restituito
Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Valore | Descrizione |
|---|---|
| S_OK | Indica che l'operazione è riuscita. |
Nota
Il modulo può restituire qualsiasi valore valido HRESULT , ma deve restituire almeno S_OK per indicare che la RegisterModule funzione ha avuto esito positivo.
Commenti
PFN_REGISTERMODULE è un prototipo di funzione per la RegisterModule funzione necessaria per implementare tutti i moduli HTTP per il punto di ingresso della DLL.
Quando si crea un modulo HTTP, il modulo deve aggiungere il metodo seguente RegisterModule :
HRESULT RegisterModule(
DWORD dwServerVersion,
IHttpModuleRegistrationInfo* pModuleInfo,
IHttpServer* pGlobalInfo
)
Per caricare il modulo, tutti i moduli HTTP devono esportare la funzione RegisterModule . È possibile esportare la RegisterModule funzione creando un file di definizione del modulo (def) per il progetto DLL o compilando il modulo usando l'opzione /EXPORT:RegisterModule .
La RegisterModule funzione dovrà usare l'interfaccia per eseguire la IHttpModuleRegistrationInfo registrazione per le notifiche usando i metodi SetRequestNotifications e SetGlobalNotifications . RegisterModule dovrà anche usare IHttpModuleRegistrationInfo per registrare le priorità dei moduli usando i metodi SetPriorityForRequestNotification e SetPriorityForGlobalNotification .
Il dwServerVersion parametro contiene il numero di versione principale per la versione di IIS che carica il modulo. Ad esempio, per IIS 7.0 il dwServerVersion parametro conterrà un valore 7.
Quando IIS chiama la RegisterModule funzione, fornisce un'interfaccia IHttpServer che il modulo può usare per recuperare informazioni a livello di server.
Nota
Gli eventi di traccia non devono essere generati (tramite il metodo IHttpTraceContext::QuickTrace o qualsiasi altro mezzo tramite il metodo IHttpServer::GetTraceContext) all'interno dell'implementazione della RegisterModule funzione. La generazione di eventi di traccia all'interno di RegisterModule può causare una violazione di accesso perché è troppo presto nella pipeline di richiesta.
Esempio
Nell'esempio di codice seguente viene illustrato come creare un semplice modulo HTTP "Hello World". Il modulo definisce una funzione esportata RegisterModule che passa un'istanza di un'interfaccia IHttpModuleFactory al metodo IHttpModuleRegistrationInfo::SetRequestNotifications e registra per la notifica di RQ_BEGIN_REQUEST . IIS usa il metodo IHttpModuleFactory::GetHttpModule per creare un'istanza di una classe CHttpModule e restituisce uno stato di esito positivo. IIS usa anche il metodo IHttpModuleFactory::Terminate per rimuovere la factory dalla memoria.
Quando si verifica una RQ_BEGIN_REQUEST notifica, IIS chiama il metodo CHttpModule::OnBeginRequest del modulo per elaborare la richiesta corrente. OnBeginRequest cancella il buffer di risposta e modifica il tipo MIME per la risposta. Il metodo crea quindi un blocco di dati che contiene una stringa "Hello World" e restituisce la stringa a un client Web. Infine, il modulo restituisce un indicatore di stato che notifica a IIS che tutte le notifiche vengono completate e quindi esce.
#define _WINSOCKAPI_
#include <windows.h>
#include <sal.h>
#include <httpserv.h>
// Create the module class.
class CHelloWorld : public CHttpModule
{
public:
REQUEST_NOTIFICATION_STATUS
OnBeginRequest(
IN IHttpContext * pHttpContext,
IN IHttpEventProvider * pProvider
)
{
UNREFERENCED_PARAMETER( pProvider );
// Create an HRESULT to receive return values from methods.
HRESULT hr;
// Retrieve a pointer to the response.
IHttpResponse * pHttpResponse = pHttpContext->GetResponse();
// Test for an error.
if (pHttpResponse != NULL)
{
// Clear the existing response.
pHttpResponse->Clear();
// Set the MIME type to plain text.
pHttpResponse->SetHeader(
HttpHeaderContentType,"text/plain",
(USHORT)strlen("text/plain"),TRUE);
// Create a string with the response.
PCSTR pszBuffer = "Hello World!";
// Create a data chunk.
HTTP_DATA_CHUNK dataChunk;
// Set the chunk to a chunk in memory.
dataChunk.DataChunkType = HttpDataChunkFromMemory;
// Buffer for bytes written of data chunk.
DWORD cbSent;
// Set the chunk to the buffer.
dataChunk.FromMemory.pBuffer =
(PVOID) pszBuffer;
// Set the chunk size to the buffer size.
dataChunk.FromMemory.BufferLength =
(USHORT) strlen(pszBuffer);
// Insert the data chunk into the response.
hr = pHttpResponse->WriteEntityChunks(
&dataChunk,1,FALSE,TRUE,&cbSent);
// Test for an error.
if (FAILED(hr))
{
// Set the HTTP status.
pHttpResponse->SetStatus(500,"Server Error",0,hr);
}
// End additional processing.
return RQ_NOTIFICATION_FINISH_REQUEST;
}
// Return processing to the pipeline.
return RQ_NOTIFICATION_CONTINUE;
}
};
// Create the module's class factory.
class CHelloWorldFactory : public IHttpModuleFactory
{
public:
HRESULT
GetHttpModule(
OUT CHttpModule ** ppModule,
IN IModuleAllocator * pAllocator
)
{
UNREFERENCED_PARAMETER( pAllocator );
// Create a new instance.
CHelloWorld * pModule = new CHelloWorld;
// Test for an error.
if (!pModule)
{
// Return an error if the factory cannot create the instance.
return HRESULT_FROM_WIN32( ERROR_NOT_ENOUGH_MEMORY );
}
else
{
// Return a pointer to the module.
*ppModule = pModule;
pModule = NULL;
// Return a success status.
return S_OK;
}
}
void
Terminate()
{
// Remove the class from memory.
delete this;
}
};
// Create the module's exported registration function.
HRESULT
__stdcall
RegisterModule(
DWORD dwServerVersion,
IHttpModuleRegistrationInfo * pModuleInfo,
IHttpServer * pGlobalInfo
)
{
UNREFERENCED_PARAMETER( dwServerVersion );
UNREFERENCED_PARAMETER( pGlobalInfo );
// Set the request notifications and exit.
return pModuleInfo->SetRequestNotifications(
new CHelloWorldFactory,
RQ_BEGIN_REQUEST,
0
);
}
Il modulo deve esportare la RegisterModule funzione. È possibile esportare questa funzione creando un file di definizione del modulo (con estensione def) per il progetto oppure è possibile compilare il modulo usando l'opzione /EXPORT:RegisterModule . Per altre informazioni, vedere Procedura dettagliata: Creazione di un modulo HTTP Request-Level tramite codice nativo.
Facoltativamente, è possibile compilare il codice usando la __stdcall (/Gz) convenzione di chiamata anziché dichiarare in modo esplicito la convenzione di chiamata per ogni funzione.
Requisiti
| Tipo | Descrizione |
|---|---|
| Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
| Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
| Prodotto | - 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 |
| Intestazione | Httpserv.h |
Vedere anche
Interfaccia IHttpModuleRegistrationInfo
Metodo IHttpModuleRegistrationInfo::SetGlobalNotifications
Metodo IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification
Metodo IHttpModuleRegistrationInfo::SetPriorityForRequestNotification
Metodo IHttpModuleRegistrationInfo::SetRequestNotifications
Interfaccia IHttpServer