CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFO control code
Updates information about the security principal associated with a designated resource. Applications use this control code as a parameter to the ClusterResourceControl function.
ClusterResourceControl( hResource, // resource handle
NULL, // optional node handle (not used)
CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFO, // this control code
lpInBuffer, // input buffer: security principal's info
cbInBufferSize, // input buffer size (bytes)
NULL, // output buffer (not used)
0, // output buffer size (not used)
NULL ); // resulting data size (not used)
Parameters
The following control code function parameters are specific to this control code. For complete parameter descriptions, see ClusterResourceControl.
-
lpInBuffer
-
Takes the security principal's information to be updated. This information is structured according to the CLUS_NETNAME_PWD_INFO structure.
Return value
ClusterResourceControl returns one of the following values.
-
ERROR_SUCCESS
-
0
The operation was successful.
-
If any other value is returned, then the operation failed.
Remarks
ClusAPI.h defines the 32 bits of CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFO (0x0100017a) 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_NETNAME_SET_PWD_INFO (0x17a) |
| Access code | 0 1 | CLUS_ACCESS_WRITE (0x2) |
For more information, see Control Code Architecture.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Header |
|