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]

要設定的值名稱。 如果索引鍵中還沒有具有此名稱的值,函式會將它新增至索引鍵。

如果 lpValueNameNull 或空字串 「」,則函式會設定索引鍵未命名或預設值的類型和資料。

如需詳細資訊,請參閱 登錄專案大小限制

登錄機碼沒有預設值,但可以有一個未命名的值,可以是任何類型的值。

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 版或更新版本
標頭
Offreg.h
DLL
Offreg.dll

另請參閱

ORCreateKey

OROpenKey