Skip to content

Latest commit

 

History

History
149 lines (109 loc) · 4.84 KB

nf-resapi-resutilsetbinaryvalue.md

File metadata and controls

149 lines (109 loc) · 4.84 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:resapi.ResUtilSetBinaryValue
ResUtilSetBinaryValue function (resapi.h)
Sets a binary value in the cluster database.
PRESUTIL_SET_BINARY_VALUE
PRESUTIL_SET_BINARY_VALUE function [Failover Cluster]
ResUtilSetBinaryValue
ResUtilSetBinaryValue function [Failover Cluster]
_wolf_resutilsetbinaryvalue
mscs.resutilsetbinaryvalue
resapi/PRESUTIL_SET_BINARY_VALUE
resapi/ResUtilSetBinaryValue
mscs\resutilsetbinaryvalue.htm
MsCS
6a32169c-af14-40f4-ac45-f9923da544ca
12/05/2018
PRESUTIL_SET_BINARY_VALUE, PRESUTIL_SET_BINARY_VALUE function [Failover Cluster], ResUtilSetBinaryValue, ResUtilSetBinaryValue function [Failover Cluster], _wolf_resutilsetbinaryvalue, mscs.resutilsetbinaryvalue, resapi/PRESUTIL_SET_BINARY_VALUE, resapi/ResUtilSetBinaryValue
resapi.h
Windows
None supported
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
ResUtils.lib
ResUtils.dll
Windows
19H1
ResUtilSetBinaryValue
resapi/ResUtilSetBinaryValue
c++
APIRef
kbSyntax
DllExport
ResUtils.dll
ResUtilSetBinaryValue

ResUtilSetBinaryValue function

-description

Sets a binary value in the cluster database.

-parameters

-param hkeyClusterKey [in]

Key identifying the location of the binary value in the cluster database.

-param pszValueName [in]

A null-terminated Unicode string containing the name of the value to update.

-param pbNewValue [in]

Pointer to the new binary value.

-param cbNewValueSize [in]

Size of the new binary value.

-param ppbOutValue [in, out, optional]

Address of a pointer to the new binary value.

-param pcbOutValueSize [in, out]

Pointer to a DWORD in which the size in bytes of the value pointed to by ppbOutValue is returned.

-returns

If the operation succeeds, the function returns ERROR_SUCCESS.

If the operation fails, the function returns a system error code. The following is a possible error code.

Return code Description
ERROR_NOT_ENOUGH_MEMORY
An error occurred during memory allocation.

-remarks

The ResUtilSetBinaryValue utility function allocates memory for the ppbOutValue pointer using the function LocalAlloc, calls the Cluster API function ClusterRegSetValue, and then copies the new value to this buffer. If the pointer is not NULL, ResUtilSetBinaryValue also deallocates it. As callers of this function, you are responsible for deallocating the buffer using the function LocalFree.

Do not call ResUtilSetBinaryValue from the following resource DLL entry point functions:

ResUtilSetBinaryValue can be safely called from any other resource DLL entry point function or from a worker thread. For more information, see Function Calls to Avoid in Resource DLLs.

-see-also

ClusterRegSetValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue