Richiamo degli script
L'uso dei parametri sostituibili (preprocessore del registrar) illustra le mappe di sostituzione e menziona il metodo Registrar AddReplacement. Il registrar include otto altri metodi specifici per la creazione di script e tutti sono descritti nella tabella seguente.
| metodo | Sintassi/Descrizione |
|---|---|
| ResourceRegister | HRESULT ResourceRegister( LPCOLESTRresFileName , UINTnID , LPCOLESTRszType ); Registra lo script contenuto nella risorsa di un modulo. resFileName indica il percorso UNC del modulo stesso. nID e szType contengono rispettivamente l'ID e il tipo della risorsa. |
| ResourceUnregister | HRESULT ResourceUnregister( LPCOLESTRresFileName , UINTnID , LPCOLESTRszType ); Annulla la registrazione dello script contenuto nella risorsa di un modulo. resFileName indica il percorso UNC del modulo stesso. nID e szType contengono rispettivamente l'ID e il tipo della risorsa. |
| ResourceRegisterSz | HRESULT ResourceRegisterSz( LPCOLESTR resFileName , LPCOLESTRszID , LPCOLESTRszType ); Registra lo script contenuto nella risorsa di un modulo. resFileName indica il percorso UNC del modulo stesso. szID e szType contengono rispettivamente l'identificatore di stringa e il tipo della risorsa. |
| ResourceUnregisterSz | HRESULT ResourceUnregisterSz( LPCOLESTR resFileName , LPCOLESTRszID , LPCOLESTRszType ); Annulla la registrazione dello script contenuto nella risorsa di un modulo. resFileName indica il percorso UNC del modulo stesso. szID e szType contengono rispettivamente l'identificatore di stringa e il tipo della risorsa. |
| FileRegister | HRESULT FileRegister( LPCOLESTR fileName ); Registra lo script in un file. fileName è un percorso UNC di un file che contiene (o è) uno script di risorsa. |
| FileUnregister | HRESULT FileUnregister( LPCOLESTR fileName ); Annulla la registrazione dello script in un file. fileName è un percorso UNC di un file che contiene (o è) uno script di risorsa. |
| StringRegister | HRESULT StringRegister( LPCOLESTR data ); Registra lo script in una stringa. i dati contengono lo script stesso. |
| StringUnregister | HRESULT StringUnregister( LPCOLESTR data ); Annulla la registrazione dello script in una stringa. i dati contengono lo script stesso. |
ResourceRegisterSz e ResourceUnregisterSz sono simili a ResourceRegister e ResourceUnregister, ma consentono di specificare un identificatore di stringa.
I metodi FileRegister e FileUnregister sono utili se non si desidera lo script in una risorsa o se si vuole che lo script sia presente nel proprio file. I metodi StringRegister e StringUnregister consentono di archiviare il file con estensione rgs in una stringa allocata dinamicamente.