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:clusapi.ClusterRegQueryValue |
ClusterRegQueryValue function (clusapi.h) |
Returns the name, type, and data components associated with a value for an open cluster database key. |
|
mscs\clusterregqueryvalue.htm |
MsCS |
78ea27da-2b95-46df-b01e-4a3717276859 |
12/05/2018 |
ClusterRegQueryValue, ClusterRegQueryValue function [Failover Cluster], REG_BINARY, REG_DWORD, REG_DWORD_BIG_ENDIAN, REG_EXPAND_SZ, REG_MULTI_SZ, REG_NONE, REG_QWORD, REG_SZ, _wolf_clusterregqueryvalue, clusapi/ClusterRegQueryValue, mscs.clusterregqueryvalue |
clusapi.h |
Windows |
None supported |
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
ClusAPI.lib |
ClusAPI.dll |
Windows |
19H1 |
|
|
|
|
|
|
Returns the name, type, and data components associated with a value for an open cluster database key.
Handle of the cluster database key to query.
Pointer to a null-terminated Unicode string containing the name of the value to be queried.
Pointer to the key's value type. This parameter can be NULL if the type is not required; otherwise, the value returned through this parameter is one of the following.
Binary data in any form.
A 32-bit number.
A 32-bit number stored in big-endian format.
A null-terminated Unicode string that contains unexpanded references to environment variables (for example, "%PATH%").
A sequence of null-terminated strings, terminated by an empty string (\0).
The following is an example:
String1\0String2\0String3\0LastString\0\0
The first \0 terminates the first string, the second to the last \0 terminates the last string, and the final \0 terminates the sequence. Note that the final terminator must be factored into the length of the string.
No defined value type.
A 64-bit number.
A null-terminated Unicode string.
Pointer to the value's data. This parameter can be NULL if the data is not required.
On input, pointer to the count of bytes in the buffer pointed to by the lpbData parameter. On output, pointer to the count of bytes in the value's data, which is placed in the content of lpbData if the caller passes in a valid pointer.
The lpbData parameter can be NULL only if lpbData is also NULL.
The function returns one of the following values.
Return code/value | Description |
---|---|
|
The operation was successful. |
|
The buffer pointed to by lpbData is not large enough to hold the data for the value. ClusterRegQueryValue stores the required size in the content of lpbData. |
If lpbData is NULL, the ClusterRegQueryValue function returns ERROR_SUCCESS and stores the size of the value's data in the content of lpbData. This information allows the caller to correctly allocate a buffer to hold the data.
If lpdwValueType is set to REG_SZ, REG_MULTI_SZ or REG_EXPAND_SZ, then lpbData also includes a NULL terminator.