Page d'accueil Microsoft Page d'accueil Microsoft
Kit de ressources des extensions serveur Microsoft FrontPage 2000

Annexes


Protocole d'appel de procédure à distance de FrontPage

Le client FrontPage et les extensions serveur FrontPage communiquent à l'aide d'un protocole d'appel de procédure à distance (RPC, Remote Procedure Call) en amont de HTTP et HTML. Quand le client FrontPage veut que les extensions serveur effectuent une opération, il envoie une requête POST au serveur.

Cette requête est adressée à une des trois bibliothèques de liens dynamiques du site Web en cours de création.

  • Les requêtes d'actions émises pendant la navigation sont adressées à shtml.dll ou à shtml.exe.
  • Les requêtes d'actions émises pendant la création du site Web sont adressées à author.dll.
  • Les requêtes d'actions administratives sont adressées à admin.dll.

 

Le corps de la requête POST contient la commande sous la forme « méthode=commande », où « commande » est une chaîne indiquant l'opération que le client FrontPage demande au serveur d'exécuter.

Les extensions serveur répondent à la requête en exécutant la commande et en renvoyant la réponse « 200 OK ». Le corps du message de la réponse contient les informations renvoyées par la commande, sous forme de paires nom-valeur imbriquées.

Le corps du message adopte la forme générale suivante :

   <html>
   <head></head>
   <body>
   <p>item1=value
   <p>item2=value
   <p>item3=<ul>
        <li>item3.1=value
        <li>item3.2=value
        <ul>
            <li>item3.3.1=value
            <li>item3.3.2=value
        </ul>
   </body>
   </html>

Pour illustrer le fonctionnement du protocole RPC, nous allons examiner une partie d'une conversation entre un client FrontPage et les extensions serveur. Dans cet exemple, le client FrontPage établit une connexion avec un serveur qui exécute les extensions serveur et identifie la version de ces extensions.

 

Par souci de clarté, cette transcription a été modifiée et les
éléments inutiles en ont été supprimés.

    GET /_vti_inf.html HTTP/1.0
    Date: Fri, 17 Apr 1998 02:05:31 GMT
    User-Agent: Mozilla/2.0 (compatible; MS FrontPage 3.0)
    Host: fp4

Le serveur répond en renvoyant le fichier. Le client lit la réponse et trouve la valeur associée à « FPShtmlScriptUrl », qui lui indique où exécuter (POST) les requêtes pour exécuter les commandes de navigation. Il demande ensuite au serveur quelle version des extensions serveur il utilise :

    POST /_vti_bin/shtml.dll/_vti_rpc HTTP/1.0
    User-Agent: MSFrontPage/4.0
    Content-Type: application/x-www-form-urlencoded
    method=server version

Les extensions serveur traitent la requête « méthode=version serveur » et renvoient les informations sur leur version :

    HTTP/1.0 200 OK
    Server: Microsoft-IIS/3.0
    Date: Fri, 17 Apr 1998 02:04:43 GMT
    Content-type: application/x-vermeer-rpc
    
    <html><head><title>RPC packet</title></head>
    <body>
        <p>method=server version
        <p>server version=
              <ul>
            <li>major ver=3
            <li>minor ver=0
            <li>phase ver=2
            <li>ver incr=926
           </ul>
    </body>
    </html>

  PRÉCÉDENT  HAUT  
 
 
  Dernière mise à jour : novembre 1998
©1998 Microsoft Corporation. Tous droits réservés. Informations légales.
Capturé par MemoWeb à partir de http://www.dwam.net/docs/fpserk/version4.0/axrpc.htm  le 19/11/01 var sc_project=3430444; var sc_invisible=0; var sc_partition=38; var sc_security="e6f6356c";