Función AddClusterResourceDependency (clusapi.h)
Crea una relación de dependencia entre dos recursos. El tipo PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY define un puntero a esta función.
Sintaxis
DWORD AddClusterResourceDependency(
[in] HRESOURCE hResource,
[in] HRESOURCE hDependsOn
);
Parámetros
[in] hResource
Controle el recurso dependiente.
[in] hDependsOn
Controle el recurso del que debe depender el recurso identificado por hResource .
Valor devuelto
Si la operación se realiza correctamente, devuelve ERROR_SUCCESS (0).
Si se produce un error en la operación, AddClusterResourceDependency devuelve uno de los códigos de error del sistema. A continuación se muestran los valores devueltos posibles.
| Código o valor devuelto | Descripción |
|---|---|
|
Un recurso depende de sí mismo. |
|
La dependencia de recursos ya existe. |
|
El recurso dependiente es el cuórum. |
|
Los recursos no están en el mismo grupo. |
|
Al menos uno de los recursos está marcado para su eliminación. |
|
El recurso dependiente ya está en línea. |
Comentarios
Una relación de dependencia creada por la función AddClusterResourceDependency afecta a cómo se mueven los recursos de un nodo a otro después de un error. Determina el orden en el que los recursos se desconectan y vuelven a estar en línea.
Los recursos de una relación de dependencia deben moverse juntos. El recurso dependiente se debe poner en línea después del recurso en el que depende.
Los dos recursos identificados por hResource y hDependsOn deben estar en el mismo grupo.
No llame a AddClusterResourceDependency si hResource ya está en línea. La llamada produce un error ERROR_RESOURCE_ONLINE . Tenga en cuenta que este comportamiento ha cambiado con Windows Server 2008. Puede llamar a AddClusterResourceDependency y modificar las dependencias de recursos sin necesidad de que el recurso se desconecte.
No llame a AddClusterResourceDependency desde un archivo DLL de recursos. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.
No pase los identificadores LPC y RPC a la misma llamada de función. De lo contrario, la llamada generará una excepción RPC y puede tener efectos destructivos adicionales. Para obtener información sobre cómo se crean los identificadores LPC y RPC, consulte Uso de identificadores de objeto y OpenCluster.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | clusapi.h |
| Library | ClusAPI.lib |
| Archivo DLL | ClusAPI.dll |