CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS control code
Retrieves the token and credentials used to validate a cluster node's access to a storage account for a Cloud Witness resource. Applications use this control code as a ClusterResourceTypeControl parameter, and resource DLLs receive the control code as a parameter to the ResourceTypeControl function.
ClusterResourceTypeControl(
hCluster, // cluster handle
lpszResourceTypeName, // resource type name
hHostNode, // optional host node
CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS, // this control code
lpInBuffer, // input buffer
nInBufferSize, // input buffer size (not used)
lpOutBuffer, // output buffer
cbOutBufferSize, // allocated buffer size
lpcbBytesReturned ); // size of returned data
Parameters
The following control code function and DLL support parameters are specific to this control code. For complete parameter descriptions, see ClusterResourceTypeControl or ResourceTypeControl.
-
lpOutBuffer
-
A pointer the retrieved credentials and token.
Return value
ClusterResourceTypeControl returns one of the following values:
-
ERROR_SUCCESS
-
0
The operation was successful.
-
ERROR_MORE_DATA
-
234 (0xEA)
The output buffer pointed to by lpOutBuffer was not large enough to hold the data resulting from the operation. The lpcbBytesReturned parameter points to the size required for the output buffer.
-
The operation failed. The value of lpcbBytesReturned is unreliable.
Implementations of ResourceTypeControl can return the above values or the following value:
-
ERROR_INVALID_FUNCTION
-
1
Requests that the Resource Monitor perform default processing (if any) for the control code addition to processing supplied by the DLL (if any).
Remarks
ClusAPI.h defines the 32 bits of CLUSCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS (0x020020E1) as follows (for more information, see Control Code Architecture).
Component | Bit location | Value |
---|---|---|
Object code | 24 31 | CLUS_OBJECT_RESOURCE_TYPE (0x2) |
Global bit | 23 | CLUS_NOT_GLOBAL (0x0) |
Modify bit | 22 | CLUS_NO_MODIFY (0x0) |
User bit | 21 | CLCTL_CLUSTER_BASE (0x0) |
Type bit | 20 | External (0x0) |
Operation code | 0 23 | CLCTL_CLOUD_WITNESS_RESOURCE_TYPE_VALIDATE_CREDENTIALS (0x20E1) |
Access code | 0 1 | CLUS_ACCESS_READ (0x1) |
Requirements
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2016 |
Header |
|