ORSetValue 函式
在離線登錄區中設定指定之登錄機碼值的資料。
DWORD ORSetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpValueName,
_In_ DWORD dwType,
_In_opt_ const BYTE *lpData,
_In_ DWORD cbData
);
-
處理 [in]
-
離線登錄區中開啟登錄機碼的控制碼。
-
lpValueName [in, optional]
-
要設定的值名稱。 如果索引鍵中還沒有具有此名稱的值,函式會將它新增至索引鍵。
如果 lpValueName 為 Null 或空字串 「」,則函式會設定索引鍵未命名或預設值的類型和資料。
如需詳細資訊,請參閱 登錄專案大小限制。
登錄機碼沒有預設值,但可以有一個未命名的值,可以是任何類型的值。
-
dwType [in]
-
lpData參數所指向的資料類型。 如需可能類型的清單,請參閱 登錄實值型別。
-
lpData [in, optional]
-
要儲存的資料。
對於字串型別,例如 REG_SZ,字串必須以 Null 結尾。 對於REG_MULTI_SZ資料類型,字串必須以兩個 Null 字元終止。
-
cbData [in]
-
lpData參數所指向的資訊大小,以位元組為單位。 如果資料的類型為 REG_SZ、REG_EXPAND_SZ 或 REG_MULTI_SZ, cbData 必須包含終止 Null 字元或字元的大小。
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標,以取得錯誤的一般描述。
值大小受限於可用的記憶體。 長值 (超過 2048 個位元組) 應該儲存為儲存在登錄中檔案名的檔案。 這可協助登錄有效率地執行。 圖示、點陣圖和可執行檔等應用程式元素應該儲存為檔案,而不是放在登錄中。
需求 | 值 |
---|---|
可轉散發套件 |
Windows 離線登錄程式庫 1.0 版或更新版本 |
標頭 |
|
DLL |
|