resUtilSetBinaryValue 函式 (resapi.h)
設定 叢集資料庫中的二進位值。
語法
DWORD ResUtilSetBinaryValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] const LPBYTE pbNewValue,
[in] DWORD cbNewValueSize,
[in, out, optional] LPBYTE *ppbOutValue,
[in, out] LPDWORD pcbOutValueSize
);
參數
[in] hkeyClusterKey
識別叢集資料庫中二進位值位置的索引鍵。
[in] pszValueName
Null 終止的 Unicode 字串，其中包含要更新的值名稱。
[in] pbNewValue
新二進位值的指標。
[in] cbNewValueSize
新二進位值的大小。
[in, out, optional] ppbOutValue
新二進位值的指標位址。
[in, out] pcbOutValueSize
DWORD 的指標，其中會傳回 ppbOutValue 所指向值的位元組大小。
傳回值
如果作業成功，函式會傳回 ERROR_SUCCESS。
如果作業失敗，函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。
| 傳回碼 | Description |
|---|---|
|
記憶體配置期間發生錯誤。 |
備註
ResUtilSetBinaryValue 公用程式函式會使用 LocalAlloc 函數為 ppbOutValue 指標配置記憶體、呼叫 Cluster API 函式 ClusterRegSetValue，然後將新值複製到這個緩衝區。 如果指標不是 NULL，ResUtilSetBinaryValue 也會解除分配它。 身為此函式的呼叫端，您必須負責使用 LocalFree函式解除分配緩衝區。
請勿從下列資源 DLL 進入點函式呼叫 ResUtilSetBinaryValue ：
您可以從任何其他資源 DLL 進入點函式或背景工作線程安全地呼叫 ResUtilSetBinaryValue。 如需詳細資訊，請參閱 在資源 DLL 中避免的函式呼叫。規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | resapi.h |
| 程式庫 | ResUtils.lib |
| Dll | ResUtils.dll |