上一個主題: 僅移轉設定的指令檔指導原則下一個主題: 指令檔語言總覽


定義

下列是用於 CA DMM 指令檔中的標準定義:

來源

如果使用者連接至網路,來源是指舊系統,如果是在獨立系統上,則來源是指儲存檔案。

目的地

「目的地」是指新電腦。

註解

您可以在指令檔中的任何地方使用 C 類型的註解。 在同一行上註解之後的所有文字都視為註解的一部份。 您可以在與敘述式同一行上的分號後面包含註解。 您不可以巢套註解。 您也可以使用雙正斜線 (//) 註解。

範例:

/*SYSTEMPATH 底下的檔案*/
StoreFile( SYSTEMPATH + "\\Olepro32.dll" );     /*儲存 Olepro32.dll 檔案*/
//這整行都是註解。
變數

變數是指令檔定義的保留字,會在第一次為它們指定值時宣告它們。 它們可以是任何字母、數字及底線符號的組合。 但是,第一個字元必須是字母。 變數不可以使用關鍵字或常數的名稱。

常數

常數是由指令檔解譯器預先定義或動態定義的變數。 它們的值取決於解譯器的狀態及其平台。 常數無法被指令檔修改,且會在工作階段中維持相同的值。

例外為 APPLICATIONPATH,它使用 Detect 關鍵字初始化,而 LANGUAGE 使用作業系統語言初始化。

預先定義的常數

預先定義的常數如下所示:

WINDOWSPATH

來源電腦上的 Windows 目錄路徑。

SYSTEMPATH

來源電腦上的系統目錄路徑。

APPLICATIONPATH

來源電腦上的應用程式目錄路徑。

NEW_WINDOWSPATH

目的地電腦上的 Windows 目錄路徑。

NEW_SYSTEMPATH

目的地電腦上的系統目錄路徑。

NEW_APPLICATIONPATH

目的地電腦上的應用程式目錄路徑。

WIN2000

代表 Windows 2000 平台。

WINXP

代表 Windows XP 32 位元平台。

WINXP64

代表 Windows XP 64 位元平台。

WINVI

代表 Windows Vista 32 位元平台。

WINVI64

代表 Windows Vista 64 位元平台。

WIN7

代表 Windows 7 32 位元平台。

WIN764

代表 Windows 7 64 位元平台。

WIN8

代表 Windows 8 32 位元平台。

WIN864

代表 Windows 8 64 位元平台。

ALWAYS

永遠覆寫檔案。

NEVER

絕不覆寫檔案。

NEWER

只在覆寫檔案比現有檔案新時才覆寫。

GENERAL

指示永遠列印列印敘述式的列印層級。

MODERATE

指示列印敘述式將列印至設定為中等層級記錄的列印層級。

DETAILED

指示列印敘述式將列印至設定為詳細層級記錄的列印層級。

VERY_DETAILED

指示列印敘述式將列印至設定為非常詳細層級記錄的列印層級。

LANGUAGE

傳回作業系統的語言識別碼。

範例:

   if (LANGUAGE == "enu")
	DoSomething();
與登錄值相關的常數

下列常數會在 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders 中的登錄值定義。 您可以指定這些常數,而不用從登錄值中擷取值。

APPDATAPATH

來源電腦上使用者「應用程式資料」的路徑,例如 C:\Documents and Settings\Default User\Application Data。

DESKTOPPATH

來源電腦上使用者「桌面」資料夾的路徑,例如 C:\Documents and Settings\Default User\Desktop。

FAVORITESPATH

來源電腦上使用者「我的最愛」資料夾的路徑,例如 C:\Documents and Settings\Default User\Favorites。

LOCALAPPDATAPATH

來源電腦上使用者「應用程式資料」的路徑,例如 C:\Documents and Settings\Default User\Local Settings\Application Data。

PERSONALPATH

來源電腦上使用者「我的文件」資料夾的路徑,例如 C:\Documents and Settings\Default User\My Documents。

PROGRAMSPATH

來源電腦上使用者「程式檔案」的路徑,例如 C:\Program Files。

STARTMENUPATH

來源電腦上的使用者「開始功能表」資料夾的路徑,例如 C:\Documents and Settings\Default User\Start Menu。

STARTUPPATH

來源電腦上使用者「啟動資料夾」的路徑,例如 C:\Documents and Settings\Default User\Start Menu\Programs\Startup。

TEMPLATESPATH

來源電腦上使用者「範本」資料夾的路徑,例如 C:\Documents and Settings\Default User\Templates。

NEW_APPDATAPATH

目的地電腦上使用者「應用程式資料」的路徑,例如 C:\Documents and Settings\Default User\Application Data。

NEW_DESKTOPPATH

目的地電腦上的使用者「桌面」資料夾的路徑,例如 C:\Documents and Settings\Default User\Desktop。

NEW_FAVORITESPATH

目的地電腦上使用者「我的最愛」資料夾的路徑,例如 C:\Documents and Settings\Default User\Favorites。

NEW_LOCALAPPDATAPATH

目的地電腦上使用者「應用程式資料」的路徑,例如 C:\Documents and Settings\Default User\Local Settings\Application Data。

NEW_PERSONALPATH

目的地電腦上使用者「我的文件」資料夾的路徑,例如 C:\Documents and Settings\Default User\My Documents。

NEW_PROGRAMSPATH

目的地電腦上使用者「程式檔案」的路徑,例如 C:\Program Files。

NEW_STARTMENUPATH

目的地電腦上使用者「開始功能表」資料夾的路徑,例如 C:\Documents and Settings\Default User\Start Menu。

NEW_STARTUPPATH

目的地電腦上使用者「啟動資料夾」的路徑,例如 C:\Documents and Settings\Default User\Start Menu\Programs\Startup。

NEW_TEMPLATESPATH

目的地電腦上使用者「範本」資料夾的路徑,例如 C:\Documents and Settings\Default User\Templates。

與布林值相關的常數

下列常數會搭配使用這些指令來取代「布林」參數:

常數如下:

SOURCE

根據 CA DMM 套用或儲存而傳回真或假的「布林」常數。

DESTINATION

永遠傳回「假」的「布林」常數。

範例:

function MyStoreFunction()
{
	var strSourceDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", SOURCE);
	
	// 做某事。
}

function MyApplyFunction()
{
	var strSourceDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", SOURCE);
	var strDestinationDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", DESTINATION);

	// 做某事。
}
列印層級

這些指令作為下列指令的第二選擇性參數:Print、PrintException。 重要層級中的 GENERAL 為最嚴重,VERY_DETAILED 為最不嚴重。 若未指定「列印層級」,參數會預設為 GENERAL。

支援下列列印層級:

使用方式:

Print(PrintException) <字串運算式>, [列印層級];

範例:

print ("重要", GENERAL);
PrintException ("較不重要", DETAILED);
布林

可以為真或假的值或結果。