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

另請參閱

ORCreateKey

OROpenKey