Appel de scripts
L’article Utilisation de paramètres remplaçables (préprocesseur d’inscription) traite des mappages de remplacement et mentionne la méthode AddReplacement du bureau d’enregistrement. Le bureau d’enregistrement possède huit autres méthodes spécifiques à l’écriture de scripts, et toutes sont décrites dans le tableau suivant.
| Method | Syntaxe/description |
|---|---|
| ResourceRegister | HRESULT ResourceRegister( LPCOLESTR resFileName , UINT nID , LPCOLESTR szType );Inscrit le script contenu dans la ressource d’un module. resFileName indique le chemin d’accès UNC du module lui-même. nID et szType contiennent respectivement l’ID et le type de la ressource. |
| ResourceUnregister | HRESULT ResourceUnregister( LPCOLESTR resFileName , UINT nID , LPCOLESTR szType );Annule l’inscription du script contenu dans la ressource d’un module. resFileName indique le chemin d’accès UNC du module lui-même. nID et szType contiennent respectivement l’ID et le type de la ressource. |
| ResourceRegisterSz | HRESULT ResourceRegisterSz( LPCOLESTR resFileName , LPCOLESTR szID , LPCOLESTR szType );Inscrit le script contenu dans la ressource d’un module. resFileName indique le chemin d’accès UNC du module lui-même. szID et szType contiennent respectivement l’identificateur et le type de chaîne de la ressource. |
| ResourceUnregisterSz | HRESULT ResourceUnregisterSz( LPCOLESTR resFileName , LPCOLESTR szID , LPCOLESTR szType );Annule l’inscription du script contenu dans la ressource d’un module. resFileName indique le chemin d’accès UNC du module lui-même. szID et szType contiennent respectivement l’identificateur et le type de chaîne de la ressource. |
| FileRegister | HRESULT FileRegister( LPCOLESTR fileName ); Inscrit le script dans un fichier. fileName est un chemin d’accès UNC vers un fichier qui contient (ou est) un script de ressource. |
| FileUnregister | HRESULT FileUnregister( LPCOLESTR fileName ); Annule l’inscription du script dans un fichier. fileName est un chemin d’accès UNC vers un fichier qui contient (ou est) un script de ressource. |
| StringRegister | HRESULT StringRegister( LPCOLESTR data ); Inscrit le script dans une chaîne. data contient le script lui-même. |
| StringUnregister | HRESULT StringUnregister( LPCOLESTR data ); Annule l’inscription du script dans une chaîne. data contient le script lui-même. |
ResourceRegisterSz et ResourceUnregisterSzsont similaires à ResourceRegister et ResourceUnregister, mais vous permettent de spécifier un identificateur de chaîne.
Les méthodes FileRegister et FileUnregister sont utiles si vous ne souhaitez pas que le script se trouve dans une ressource ou si vous souhaitez que le script se trouve dans son propre fichier. Les méthodes StringRegister et StringUnregister permettent au fichier .rgs d’être stocké dans une chaîne allouée dynamiquement.