Funzione WebhostRegisterProtocol

Dichiara il protocollo supportato dall'adattatore del listener.

Sintassi

HRESULT WebhostRegisterProtocol(  
   IN LPCWSTR ProtocolId,  
   IN VOID* pListenerCallbacks,  
   IN VOID* pContext,  
   OUT DWORD* pProtocolHandle  
);  

Parametri

ProtocolId
[IN] Stringa contenente il protocollo supportato da questo adattatore listener.

pListenerCallbacks
[IN] Puntatore VOID alla struttura WEBHOST_LISTENER_CALLBACKS .

pContext
[IN] Puntatore arbitrario VOID che passerà l'adattatore del listener.

pProtocolHandle
[OUT] Puntatore a un DWORD oggetto contenente la chiave univoca del processo che rappresenta questo protocollo.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

valore	Definizione
S_OK	Indica che l'operazione è riuscita.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS )	Indica che è già presente un adattatore listener registrato in questo processo per questo protocollo.
E_INVALIDARG	Indica che uno dei parametri non è valido.
E_OUTOFMEMORY	Indica che la memoria dell'heap è esaurita.

Commenti

È necessario chiamare prima la WebhostRegisterProtocol funzione quando si avvia un adattatore del listener. WebhostRegisterProtocol è asincrono, pertanto un risultato restituito con esito positivo non garantisce che la chiamata sia riuscita. Il servizio di attivazione dei processi Windows (WAS) notifica al listener la corretta registrazione usando la funzione PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED viene passato nel pListenerCallbacks parametro a questa chiamata.

È necessario impostare un timeout affinché l'adattatore listener attenda la PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED funzione di callback. Se il timeout scade, è necessario arrestare il servizio adattatore listener e contrassegnarlo come non riuscito. Un risultato restituito correttamente da questa chiamata indica che la libreria client è in attesa del servizio attivazione processo Di Windows e si connetterà quando possibile.

Non è consigliabile impostare lo stato del servizio listener su SERVICE_RUNNING da questa funzione di callback. È consigliabile impostare lo stato del servizio su SERVICE_RUNNING solo quando l'inizializzazione è stata completata e il listener del protocollo è in ascolto (in genere dopo la notifica di PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED ).

Il pContext parametro viene passato all'adattatore del listener ogni volta che viene richiamata una funzione di callback. Può essere usato quando vengono implementati più protocolli che usano la stessa struttura di callback.

Affinché la libreria client possa connettersi al servizio di attivazione dei processi di Windows, è necessario soddisfare le condizioni seguenti:

• La <listenerAdapters> sezione di configurazione nel file Was.config deve dichiarare il protocollo e l'identità in cui verranno eseguiti gli adattatori del listener.

• Il servizio di attivazione del processo Di Windows deve essere in esecuzione.

• I servizi adattatori del listener devono essere registrati in base al servizio di attivazione del processo di Windows.

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

Funzione PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED
Funzioni esportate dell'adapter listener