CLUSCTL_RESOURCE_TYPE_STORAGE_IS_CSV_FILE control code

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.

System error code

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
ClusAPI.h

See also

External Resource Type Control Codes

ClusterResourceControl

ResourceControl