CComModule::UpdateRegistryFromResourceD
更新 : 2007 年 11 月
ATL 7.0 では、CComModule は互換性のために残されています。詳細については、「ATL モジュール クラス」を参照してください。
virtual HRESULT UpdateRegistryFromResourceD(
LPCTSTR lpszRes,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL
) throw( );
virtual HRESULT UpdateRegistryFromResourceD(
UINT nResID,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL
) throw ( );
パラメータ
lpszRes
[入力] リソース名。nResID
[入力] リソース ID。bRegister
[入力] オブジェクトを登録するかどうかを示す値。pMapEntries
[入力] 置換マップへのポインタ。置換マップには、スクリプトの置き換え可能パラメータに関連付けられた値が格納されます。ATL は %MODULE% を自動的に使います。置き換え可能パラメータを使用するには、「解説」を参照してください。それ以外の場合は、既定値の NULL を使ってください。
戻り値
標準の HRESULT 値を返します。
解説
lpszRes または nResID で指定されたリソースに含まれているスクリプトを実行します。
bRegister が TRUE の場合は、オブジェクトをレジストリに登録します。それ以外の場合は、オブジェクトの登録を解除します。
DECLARE_REGISTRY_RESOURCE マクロまたは DECLARE_REGISTRY_RESOURCEID マクロを指定すると、オブジェクト マップが処理されるときに UpdateRegistryFromResourceD が自動的に呼び出されます。
.gif "メモ") メモ : |
|---|
実行時に置き換え値を代入するには、DECLARE_REGISTRY_RESOURCE マクロまたは DECLARE_REGISTRY_RESOURCEID マクロを指定しないでください。その代わりに、_ATL_REGMAP_ENTRIES 構造体の配列を作成します。この配列の各エントリに変数のプレースホルダと値をペアにして格納し、実行時にこのプレースホルダを置き換えます。次に、この配列をパラメータ pMapEntries として UpdateRegistryFromResourceD を呼び出します。この結果、_ATL_REGMAP_ENTRIES 構造体のすべての置換値がレジストラの置換マップに追加されます。 |
| メモ : |
|---|
ATL レジストリ コンポーネント (レジストラ) へ静的にリンクする方法については、「UpdateRegistryFromResourceS」を参照してください。 |
置換可能パラメータとスクリプトの詳細については、「ATL レジストリ コンポーネント (レジストラ)」を参照してください。
必要条件
ヘッダー : atlbase.h