DMM Studio 線上說明 › DMM Studio › 語言結構 › 套用指令

套用指令

下列是用於 CA DMM 指令檔中的「套用」指令。

ApplyDirectory

將目錄內容從來源套用至目的地電腦。 此指令使用兩個或三個參數。 第一個參數是目錄路徑，且為字串值。 第二個參數是下列覆寫常數之一或新目錄路徑。 有三個常數指示覆寫方法：ALWAYS、NEWER 或 NEVER。 如果忽略覆寫常數，則套用預設的 NEWER 或使用者選取的覆寫方法。 如果第二個參數是新目錄路徑，則會將目錄 <目錄名稱> 的內容套用至 <新目錄名稱>。 允許選擇性的覆寫方法。 只能套用已經儲存的目錄。 移動時，如果儲存路徑包含萬用字元，請勿在移動路徑中包含萬用字元。

第一個參數：

目錄名稱 (字串值)

第二個參數：

新目錄名稱 (字串值)

第三個參數：

覆寫方法 (字串值)

使用方式：

ApplyDirectory(<目錄名稱>, [覆寫方法]); 或

ApplyDirectory(<目錄名稱>, <新目錄名稱>, [覆寫方法]);

範例：

ApplyDirectory("c:\\My Documents");
ApplyDirectory("c:\\My Documents", NEWER);
ApplyDirectory("c:\\My Documents", "c:\\Word Documents");
ApplyDirectory("c:\\My Documents", "c:\\Word Documents", ALWAYS);
/*萬用字元範例*/
ApplyDirectory("c:\\My Documents\\*.fol", "c:\\New Path\\Word Documents", ALWAYS);

ApplyFile

將檔案從來源套用至目的地電腦。 此指令使用兩個或三個參數。 第一個參數是檔案名稱，且為字串值。 第二個參數是下列覆寫常數之一或新檔案路徑。 有三個常數指示覆寫方法：ALWAYS、NEWER 或 NEVER。 如果忽略覆寫常數，則套用預設的 NEWER 或使用者選取的覆寫方法。 如果第二個參數是新檔案路徑，則會將檔案 <檔案名稱> 套用至 <新檔案名稱>。 也允許使用選擇性的覆寫方法。 此指令會將星號 (*) 識別為萬用字元。 只能套用儲存的檔案。 移動時，如果儲存路徑包含萬用字元，請勿在移動路徑中包含萬用字元。

第一個參數：

檔案名稱 (字串值)

第二個參數：

新檔案名稱 (字串值)

第三個參數：

覆寫方法 (字串值)

使用方式：

ApplyFile(<檔案名稱>, [覆寫方法]); 或

ApplyFile(<檔案名稱>, <新檔案名稱>, [覆寫方法]);

範例：

ApplyFile("c:\\temp\\file.txt");
/*萬用字元範例*/
ApplyFile("c:\\My Documents\\*.txt", "c:\\New Path\\Word Documents", ALWAYS);

ApplyKey

從來源將登錄機碼 (包括其所有值或 ini 檔案區段及其所有值) 套用至目的地電腦。 此指令可以使用兩個參數。 只能套用已儲存的機碼。

第一個參數：

機碼路徑 (字串值)

第二個參數：

新機碼路徑 (字串值)

使用方式：

ApplyKey(<機碼路徑>, [new Key path]);

範例

ApplyKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedFile

將檔案從來源套用至目的地電腦。 如果任何檔案資料指定目錄路徑，會將它對映至正確路徑。

第一個參數：

檔案路徑 (字串值)

第二個參數：

新檔案名稱 (字串值)

第三個參數：

覆寫方法 (字串值)

使用方式：

ApplyMappedFile(<檔案名稱>, [覆寫方法]); 或

ApplyMappedFile(<檔案名稱>, <新檔案名稱>, [覆寫方法]);

範例：

ApplyMappedFile("c:\\temp\\file.txt");

ApplyMappedFile("c:\\My Documents\\file.txt", "c:\\New Path\\Word Documents\\file.txt", ALWAYS);

ApplyMappedKey

將登錄機碼及其所有值或 ini 檔案區段及其所有值從來源電腦套用至目的地電腦。 如果任何值名稱或值資料是目錄路徑，會將它們對映至適當的路徑。 此指令可以使用兩個參數。 只能套用已儲存的機碼。

第一個參數：

機碼路徑 (字串值)

第二個參數：

新機碼路徑 (字串值)

使用方式：

ApplyMappedKey(<機碼路徑>, [新機碼路徑]);

範例：

ApplyMappedKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedSubKeys

將登錄機碼、其所有值及其所有子機碼，或 ini 檔案區段及其所有值從來源電腦套用至目的地電腦。 如果任何值名稱或值資料是目錄路徑，會將它們對映至適當的路徑。 此指令可以使用兩個參數。 只能套用已儲存的機碼。

第一個參數：

機碼路徑 (字串值)

第二個參數：

新機碼路徑 (字串值)

使用方式：

ApplyMappedSubKeys(<機碼路徑>, [新機碼路徑]);

範例：

ApplyMappedSubKeys("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedValue

從來源將登錄機碼值或 .ini 檔案值套用至目的地電腦。 如果值名稱或值為目錄路徑，會將它對映到正確路徑。 此指令可以使用六個參數。 只有對映儲存的值才能對映套用。

第一個參數：

機碼路徑 (字串值)

第二個參數：

值名稱 (字串值)

附註：如果值是預設值，第二個參數應為 NULL ("")

第三個參數：

新機碼路徑 (字串值)

附註：若未將值移至新位置，第三個參數應為 NULL ("")

第四個參數：

分隔符號 (字串值)

第五個參數：

短路徑指示器 (布林值)

第六個參數：

若移動，則為新值名稱 (字串值)

使用方式：

ApplyMappedValue(<機碼路徑>, <值名稱>, [new Key path], [delimiter], [shortpaths], [new Value name]);

範例：

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips","HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", "", ";", true);

ApplySubKeys

將登錄機碼、其所有值及其所有子機碼從來元電腦套用至目的地電腦。 此指令可以使用兩個參數。 只能套用已儲存的機碼。

第一個參數：

機碼路徑 (字串值)

第二個參數：

新機碼路徑 (字串值)

使用方式：

ApplySubKeys(<機碼路徑>, [new Key path]);

範例：

ApplySubKeys("HKCU\\Software\\Microsoft\\Office\\8.0\\Word");

ApplyValue

將登錄機碼值從來源套用至目的地電腦。 此指令使用四個參數。 只能套用已儲存的值。

第一個參數：

機碼路徑 (字串值)

第二個參數：

值名稱 (字串值)

第三個參數：

新機碼路徑 (字串值)

第四個參數：

新值名稱 (字串值)

使用方式：

ApplyValue(<機碼路徑>, <值名稱>, [新機碼路徑], [新值名稱]);

範例：

ApplyValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

DeleteKey

從登錄值或 ini 檔案中刪除機碼及其所有值與子機碼。 如果刪除機碼時發生問題則傳回「假」。 如果機碼不存在，它會傳回「真」。 如果是 ini 檔案的路徑，則會刪除 ini 檔案中的所有區段。

第一個參數：

機碼路徑 (字串值)

範例：

DeleteKey( "HKCU\\Software\\MyApp");
DeleteKey( "c:\\windows\\test.ini\\Keyname");
/* 刪除所有機碼 */
DeleteKey( "c:\\windows\\test.ini");

DeleteValue

從登錄值或 ini 檔案中刪除值。 如果刪除值時發生問題則傳回假。 如果值不存在，它將會傳回真。

第一個參數：

機碼路徑 (字串值)

第二個參數：

值名稱 (字串值)

範例：

DeleteValue( "HKCU\\Software\\MyApp", "SomeValue");

DeleteValue( "c:\\windows\\win.ini\", "SomeValue");

SetKey

建立或設定機碼。

第一個參數：

機碼路徑 (字串值)

範例：

SetKey("HKLM\\New Key");

SetValue

SetValue 指令建立或設定一個機碼值。 如果機碼不存在，這個指令將會建立機碼。

此指令格式如下：

SetValue(<FilePath>, <ValueName>, <Data>, <Type>)

FilePath

(若為登錄值) 代表機碼路徑 (字串值)。

(若為 XML) 代表完整的檔案路徑。

ValueName

(若為登錄值) 代表值名稱 (字串值)。

(若為 XML) 代表有效的 XPath 查詢。

Data

代表值。

Type

代表值類型。

下列是接受的登錄值：

範例：設定一個機碼值

• 這個範例設定一個登錄機碼值：

  SetValue("HKLM\\Destination", "String Value", "This is a string value", STRING);
  

• 這個範例設定一個 XML 機碼值：

  SetValue("C:\\abc.xml", "/docnode/node1/node2", "It is a node", "");