Funzione WebhostOpenListenerChannelInstance

Richiede l'avvio di un canale listener in un processo di lavoro per questo pool di applicazioni.

Sintassi

HRESULT WebhostOpenListenerChannelInstance(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId,  
   IN PBYTE ListenerChannelBlob,  
   IN DWORD ListenerChannelBlobByteCount  
);  

Parametri

ProtocolHandle
[IN] Oggetto DWORD che contiene l'handle del protocollo per il canale del listener.

AppPoolId
[IN] Stringa contenente l'ID del pool di applicazioni per il canale di listener.

ListenerChannelId
[IN] Oggetto DWORD contenente l'identificatore del canale del listener.

ListenerChannelBlob
[IN] Oggetto PBYTE che contiene informazioni necessarie per connettere il processo di lavoro al listener. I dati non sono visibili al servizio di attivazione dei processi di Windows (WAS). Per altre informazioni, vedere la sezione Osservazioni di seguito.

ListenerChannelBlobByteCount
[IN] Oggetto DWORD contenente il numero di byte nel BLOB del canale di listener.

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 ha avuto esito positivo.
E_INVALIDARG	Indica che uno dei parametri non è valido.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND)	Indica che il protocollo non è stato registrato.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED)	Indica che l'adattatore listener non è connesso al servizio attivazione processo di Windows.

Commenti

La funzione viene chiamata quando il canale listener riceve la prima richiesta o quando il servizio attivazione processo di Windows notifica all'adattatore listener che può avviare un'altra istanza del canale del listener.

Il ListenerChannelBlob parametro viene passato al servizio attivazione processo di Windows, al processo di lavoro e al gestore del protocollo. Se l'adapter listener esegue il routing delle richieste per applicazione, il BLOB conterrà probabilmente la chiave dell'applicazione che il gestore del protocollo di elaborazione dovrà passare alla gestione protocolli. Gestione protocolli deve essere connessa la chiave dell'applicazione per il gestore del protocollo di dominio dell'applicazione. I dettagli del BLOB vengono lasciati al writer del protocollo.

Per impostazione predefinita, il servizio attivazione processo di Windows stabilisce un processo di riciclo sovrapposto, in cui il processo di lavoro che deve essere arrestato viene mantenuto in esecuzione fino a quando non viene avviato un nuovo processo di lavoro. Il servizio attivazione processo di Windows salva il BLOB del canale listener e lo userà per chiedere al nuovo processo di lavoro di connettersi. Ciò significa che il canale del listener deve essere in grado di accettare più processi che si connettono.

Il servizio attivazione processo windows non gestisce il modo in cui un canale listener si riferisce a un'applicazione, ad esempio il listener può scegliere di avere molti canali listener per pool di applicazioni o solo uno. Pertanto, il servizio attivazione processo di Windows non può determinare per l'adattatore listener cosa dovrebbe accadere ai canali del listener quando si verificano modifiche. Il servizio attivazione processo di Windows notifica solo l'adattatore listener e consente di gestire tali decisioni.

È necessario impostare gli elenchi di controllo di accesso dei canali di ascolto (ACL) all'identità del pool di applicazioni.

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	Listeneradapter.h

Vedere anche

Funzioni esportate dell'adattatore listener