Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Queries whether a file is stored on a cluster shared volume (CSV) that is accessible to all nodes in the cluster. Applications use this control code as a parameter to the ClusterResourceTypeControl function, and resource DLLs receive the control code as a parameter to the ResourceTypeControl callback function.
ClusterResourceTypeControl( hCluster, // cluster handle
lpszResTypeName, // resource type name
hHostNode, // optional host node
CLUSCTL_RESOURCE_TYPE_STORAGE_IS_CSV_FILE, // this control code
lpInBuffer, // input buffer: path to file
cbInBufferSize, // input buffer size
NULL, // lpOutBuffer not used
0, // cbOutBufferSize not used
NULL ); // lpcbBytesReturned not used
Parameters
The following control code function parameters are specific to this control code. For complete parameter descriptions, see ClusterResourceTypeControl or ResourceTypeControl.
-
lpInBuffer [in]
-
Pointer to null-terminated Unicode string containing the path to a file.
-
nInBufferSize [in]
-
Number of bytes in the buffer pointed to by lpInBuffer.
Return value
ClusterResourceTypeControl returns one of the following values.
-
ERROR_SUCCESS
-
0
The specified file is on a CSV.
-
ERROR_CLUSTER_NOT_SHARED_VOLUME
-
5945 (0x1739)
The specified file is not on a CSV.
-
The operation failed.
Remarks
The 32 bits of CLUSCTL_RESOURCE_TYPE_STORAGE_IS_CSV_FILE (0x01000229) are defined as follows.
| Component | Bit location | Value |
|---|---|---|
| Object code |
24 31 |
CLUS_OBJECT_RESOURCE (0x1) |
| 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_STORAGE_IS_CSV_FILE (0x229) |
| Access code |
0 1 |
CLUS_ACCESS_READ (0x1) |
For more information, see Control Code Architecture.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise |
| Header |
|