Partager via

Fonction WebhostRegisterProtocol

Déclare le protocole pris en charge par l’adaptateur d’écouteur.

Syntaxe

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

Paramètres

ProtocolId
[IN] Chaîne qui contient le protocole pris en charge par cet adaptateur d’écouteur.

pListenerCallbacks
[IN] Pointeur VOID vers la structure WEBHOST_LISTENER_CALLBACKS .

pContext
[IN] Pointeur arbitraire VOID que l’adaptateur de l’écouteur passera.

pProtocolHandle
[OUT] Pointeur vers un DWORD qui contient la clé unique de processus qui représente ce protocole.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur Définition
S_OK Indique que l’opération a réussi.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS ) Indique qu’un adaptateur d’écouteur est déjà inscrit dans ce processus pour ce protocole.
E_INVALIDARG Indique que l’un des paramètres n’est pas valide.
E_OUTOFMEMORY Indique que la mémoire du tas est épuisée.

Remarques

Vous devez d’abord appeler la WebhostRegisterProtocol fonction lorsque vous démarrez un adaptateur d’écouteur. WebhostRegisterProtocol étant asynchrone, un retour réussi ne garantit pas que l’appel a réussi. Le service WAS (Windows Process Activation Service) avertit l’écouteur de la réussite de l’inscription à l’aide de la fonction PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED est passé dans le pListenerCallbacks paramètre à cet appel.

Vous devez définir un délai d’attente pour que l’adaptateur de l’écouteur attende la PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED fonction de rappel. Si le délai d’expiration expire, vous devez arrêter le service de l’adaptateur d’écouteur et le marquer comme ayant échoué. Un retour réussi de cet appel indique que la bibliothèque cliente attend le service d’activation de processus Windows et se connecte lorsque cela est possible.

Vous ne devez pas définir le service d’écouteur status sur SERVICE_RUNNING à partir de cette fonction de rappel. Vous devez définir le status de service sur SERVICE_RUNNING uniquement lorsque l’initialisation est terminée et que l’écouteur de protocole écoute (généralement après la notification PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED).

Le pContext paramètre est passé à l’adaptateur de l’écouteur chaque fois qu’une fonction de rappel est appelée. Il peut être utilisé lorsque plusieurs protocoles qui utilisent la même structure de rappel sont implémentés.

Pour que la bibliothèque cliente se connecte au service d’activation de processus Windows, les conditions suivantes doivent être remplies :

  • La <listenerAdapters> section de configuration du fichier Was.config doit déclarer le protocole et l’identité sous lesquels les adaptateurs d’écouteurs seront exécutés.

  • Le service d’activation de processus Windows doit être en cours d’exécution.

  • Les services d’adaptateur d’écouteur doivent s’inscrire comme dépendants du service d’activation de processus Windows.

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - 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
En-tête Listeneradapter.h

Voir aussi

fonction PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED
Fonctions exportées de l’adaptateur d’écouteur

  • Last updated on