Function Calls to Avoid in Resource DLLs

  • [アーティクル]

Function calls involving the following functions or control codes can cause deadlock when made from resource DLLs. The following table lists these functions along with a usage code. A subsequent table describes the usage codes.

API element Usage code
AddClusterResourceDependency Do not use.
AddClusterResourceNode Worker thread only.
CanResourceBeDependent Worker thread only.
ChangeClusterResourceGroup Do not use.
CLUSCTL_GROUP_ENUM_COMMON_PROPERTIES Worker thread only.
CLUSCTL_GROUP_ENUM_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_GROUP_GET_CHARACTERISTICS Worker thread only.
CLUSCTL_GROUP_GET_COMMON_PROPERTIES Worker thread only.
CLUSCTL_GROUP_GET_COMMON_PROPERTY_FMTS Worker thread only.
CLUSCTL_GROUP_GET_FLAGS Worker thread only.
CLUSCTL_GROUP_GET_ID Worker thread only.
CLUSCTL_GROUP_GET_NAME Worker thread only.
CLUSCTL_GROUP_GET_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_GROUP_GET_PRIVATE_PROPERTY_FMTS Worker thread only.
CLUSCTL_GROUP_GET_RO_COMMON_PROPERTIES Worker thread only.
CLUSCTL_GROUP_GET_RO_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_GROUP_QUERY_DELETE Worker thread only.
CLUSCTL_GROUP_SET_COMMON_PROPERTIES Worker thread only.
CLUSCTL_GROUP_SET_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_GROUP_UNKNOWN Worker thread only.
CLUSCTL_GROUP_VALIDATE_COMMON_PROPERTIES Worker thread only.
CLUSCTL_GROUP_VALIDATE_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_ADD_DEPENDENCY Worker thread only.
CLUSCTL_RESOURCE_ADD_OWNER Worker thread only.
CLUSCTL_RESOURCE_CLUSTER_NAME_CHANGED Worker thread only.
CLUSCTL_RESOURCE_CLUSTER_VERSION_CHANGED Worker thread only.
CLUSCTL_RESOURCE_DELETE Worker thread only.
CLUSCTL_RESOURCE_ENUM_COMMON_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_EVICT_NODE Worker thread only.
CLUSCTL_RESOURCE_GET_CHARACTERISTICS Worker thread only.
CLUSCTL_RESOURCE_GET_CLASS_INFO Worker thread only.
CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_GET_FLAGS Worker thread only.
CLUSCTL_RESOURCE_GET_ID Worker thread only.
CLUSCTL_RESOURCE_GET_NAME Worker thread only.
CLUSCTL_RESOURCE_GET_NETWORK_NAME Worker thread only.
CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_GET_REQUIRED_DEPENDENCIES Worker thread only.
CLUSCTL_RESOURCE_GET_RESOURCE_TYPE Worker thread only.
CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_GET_RO_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_INSTALL_NODE Worker thread only.
CLUSCTL_RESOURCE_REMOVE_DEPENDENCY Worker thread only.
CLUSCTL_RESOURCE_REMOVE_OWNER Worker thread only.
CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_SET_NAME Worker thread only.
CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO Worker thread only.
CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO_EX Worker thread only.
CLUSCTL_RESOURCE_STORAGE_GET_MOUNTPOINTS Worker thread only.
CLUSCTL_RESOURCE_STORAGE_IS_PATH_VALID Worker thread only.
CLUSCTL_RESOURCE_UNKNOWN Worker thread only.
CLUSCTL_RESOURCE_VALIDATE_COMMON_PROPERTIES Worker thread only.
CLUSCTL_RESOURCE_VALIDATE_PRIVATE_PROPERTIES Worker thread only.
ClusterGroupEnum Worker thread only.
ClusterGroupOpenEnum Worker thread only.
ClusterRegCreateKey Some entry points okay.
ClusterRegDeleteKey Some entry points okay.
ClusterRegDeleteValue Some entry points okay.
ClusterRegSetKeySecurity Some entry points okay.
ClusterRegSetValue Some entry points okay.
ClusterResourceEnum Worker thread only.
ClusterResourceOpenEnum Worker thread only.
CreateClusterGroup Do not use.
CreateClusterResource Do not use.
DeleteClusterGroup Do not use.
DeleteClusterResource Do not use.
DestroyClusterGroup Do not use.
FailClusterResource Do not use.
GetClusterGroupState Worker thread only.
GetClusterResourceNetworkName Worker thread only.
GetClusterResourceState Worker thread only.
MoveClusterGroup Do not use.
OfflineClusterGroup Do not use.
OfflineClusterResource Do not use.
OnlineClusterGroup Do not use.
OnlineClusterResource Do not use.
RemoveClusterResourceDependency Do not use.
RemoveClusterResourceNode Do not use.
ResUtilFindDependentDiskResourceDriveLetter Do not use.
ResUtilGetResourceDependentIPAddressProps Worker thread only.
ResUtilGetEnvironmentWithNetName Worker thread only.
ResUtilGetResourceDependency Worker thread only.
ResUtilGetResourceDependencyByClass Worker thread only.
ResUtilGetResourceDependencyByName Worker thread only.
ResUtilGetResourceNameDependency Worker thread only.
ResUtilSetBinaryValue Some entry points okay.
ResUtilSetDwordValue Some entry points okay.
ResUtilSetExpandSzValue Some entry points okay.
ResUtilSetMultiSzValue Some entry points okay.
ResUtilSetPrivatePropertyList Some entry points okay.
ResUtilSetPropertyParameterBlock Some entry points okay.
ResUtilSetPropertyParameterBlockEx Some entry points okay.
ResUtilSetPropertyTable Some entry points okay.
ResUtilSetPropertyTableEx Some entry points okay.
ResUtilSetResourceServiceEnvironment Worker thread only.
ResUtilSetSzValue Some entry points okay.
ResUtilSetUnknownProperties Some entry points okay.
SetClusterGroupName Do not use.
SetClusterGroupNodeList Do not use.
SetClusterName Do not use.
SetClusterQuorumResource Do not use.
SetClusterResourceName Do not use.
SetClusterServiceAccountPassword Do not use.

 

The following table describes the usage codes presented in the previous table.

Usage code Usage notes
Some entry points okay. Do not call these functions from the following resource DLL entry point functions: Close, Offline, Online, Open, Terminate. These functions can be safely called from any other resource DLL entry point function or from a worker thread.
Worker thread only. These functions should be called only from a worker thread (see ClusWorkerCreate, ClusWorkerCheckTerminate, and ClusWorkerTerminate).
Do not use. Do not call any of these functions from a resource DLL. Functions in this category modify dependency relationships, add or remove resources from groups, create or delete groups or resources, cause resource or group state changes, or change the node lists of groups or resources.