Invocando scripts
Usando parâmetros substituíveis (o processador do registrador) aborda mapas de substituição e menciona o método AddReplacement do registrador. O registrador tem outros oito métodos específicos para script e todos são descritos na tabela a seguir.
| Método | Sintaxe/descrição |
|---|---|
| ResourceRegister | HRESULT ResourceRegister( LPCOLESTR resFileName , UINT nID , LPCOLESTR szType );Registra o script contido no recurso de um módulo. resFileName indica o caminho UNC para o próprio módulo. nID e szType contêm a ID e o tipo do recurso, respectivamente. |
| ResourceUnregister | HRESULT ResourceUnregister( LPCOLESTR resFileName , UINT nID , LPCOLESTR szType );Cancela o registro do script contido no recurso de um módulo. resFileName indica o caminho UNC para o próprio módulo. nID e szType contêm a ID e o tipo do recurso, respectivamente. |
| ResourceRegisterSz | HRESULT ResourceRegisterSz( LPCOLESTR resFileName , LPCOLESTR szID , LPCOLESTR szType );Registra o script contido no recurso de um módulo. resFileName indica o caminho UNC para o próprio módulo. szID e szType contêm o identificador e o tipo de cadeia de caracteres do recurso, respectivamente. |
| ResourceUnregisterSz | HRESULT ResourceUnregisterSz( LPCOLESTR resFileName , LPCOLESTR szID , LPCOLESTR szType );Cancela o registro do script contido no recurso de um módulo. resFileName indica o caminho UNC para o próprio módulo. szID e szType contêm o identificador e o tipo de cadeia de caracteres do recurso, respectivamente. |
| FileRegister | HRESULT FileRegister( LPCOLESTR fileName ); Registra o script em um arquivo. fileName é um caminho UNC para um arquivo que contém (ou é) um script de recurso. |
| FileUnregister | HRESULT FileUnregister( LPCOLESTR fileName ); Cancela o registro do script em um arquivo. fileName é um caminho UNC para um arquivo que contém (ou é) um script de recurso. |
| StringRegister | HRESULT StringRegister( LPCOLESTR data ); Registra o script em um script. data contêm o próprio script. |
| StringUnregister | HRESULT StringUnregister( LPCOLESTR data ); Cancela o registro do script em um script. data contêm o próprio script. |
ResourceRegisterSz e ResourceUnregisterSz são semelhantes a ResourceRegister e ResourceUnregister, mas permitem que você especifique um identificador de cadeia de caracteres.
Os métodos FileRegister e FileUnregister são úteis se você não quiser o script em um recurso ou se quiser o script no próprio arquivo. Os métodos StringRegister e StringUnregister permitem que o arquivo .rgs seja armazenado em uma cadeia de caracteres alocada dinamicamente.