Funzione AddClusterResourceDependency (clusapi.h)
Crea una relazione di dipendenza tra due risorse. Il tipo PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY definisce un puntatore a questa funzione.
Sintassi
DWORD AddClusterResourceDependency(
[in] HRESOURCE hResource,
[in] HRESOURCE hDependsOn
);
Parametri
[in] hResource
Gestire la risorsa dipendente.
[in] hDependsOn
Gestire la risorsa da cui dipende la risorsa identificata da hResource .
Valore restituito
Se l'operazione ha esito positivo, restituisce ERROR_SUCCESS (0).
Se l'operazione non riesce, AddClusterResourceDependency restituisce uno dei codici di errore di sistema. Di seguito sono riportati i possibili valori restituiti.
| Codice/valore restituito | Descrizione |
|---|---|
|
Una risorsa dipende da se stessa. |
|
La dipendenza della risorsa esiste già. |
|
La risorsa dipendente è il quorum. |
|
Le risorse non si trovano nello stesso gruppo. |
|
Almeno una delle risorse è contrassegnata per l'eliminazione. |
|
La risorsa dipendente è già online. |
Commenti
Una relazione di dipendenza creata dalla funzione AddClusterResourceDependency influisce sul modo in cui le risorse vengono spostate da un nodo a un altro dopo un errore. Determina l'ordine in cui le risorse vengono portate offline e riportate online.
Le risorse in una relazione di dipendenza devono essere spostate insieme. La risorsa dipendente deve essere portata online dopo la risorsa da cui dipende.
Le due risorse identificate da hResource e hDependsOn devono trovarsi nello stesso gruppo.
Non chiamare AddClusterResourceDependency se hResource è già online. La chiamata ha esito negativo e viene visualizzato un errore di ERROR_RESOURCE_ONLINE . Si noti che questo comportamento è stato modificato con Windows Server 2008. È possibile chiamare AddClusterResourceDependency e modificare le dipendenze delle risorse senza richiedere che la risorsa venga portata offline.
Non chiamare AddClusterResourceDependency da una DLL di risorse. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.
Non passare handle LPC e RPC alla stessa chiamata di funzione. In caso contrario, la chiamata genererà un'eccezione RPC e può avere effetti distruttivi aggiuntivi. Per informazioni sulla creazione di handle LPC e RPC, vedere Using Object Handle e OpenCluster.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |