PSET_RESOURCE_STATUS_ROUTINE funzione di callback (resapi.h)

Articolo
08/25/2023

Chiamato per aggiornare lo stato di una risorsa. Il tipo PSET_RESOURCE_STATUS_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PSET_RESOURCE_STATUS_ROUTINE PsetResourceStatusRoutine;

DWORD PsetResourceStatusRoutine(
  [in] RESOURCE_HANDLE ResourceHandle,
  [in] PRESOURCE_STATUS ResourceStatus
)
{...}

Parametri

[in] ResourceHandle

Gestire l'identificazione della risorsa da aggiornare. Il parametro ResourceHandle deve contenere lo stesso handle usato per il parametro ResourceHandle nel punto di ingresso Open per questa risorsa.

[in] ResourceStatus

Puntatore a una struttura RESOURCE_STATUS che contiene informazioni sullo stato della risorsa.

Valore restituito

SetResourceStatus restituisce uno dei valori seguenti enumerati dall'enumerazione RESOURCE_EXIT_STATE .

Codice/valore restituito	Descrizione
ResourceExitStateContinue 0	La risorsa non è stata terminata. I thread di lavoro possono continuare operazioni online e offline per la risorsa.
ResourceExitStateTerminate 1	La risorsa è stata terminata. I chiamanti devono terminare operazioni online o offline e terminare immediatamente tutti i thread di lavoro assegnati alla risorsa.

Commenti

Le DLL delle risorse chiamano la funzione callback SetResourceStatus per aggiornare lo stato di una risorsa dopo che la funzione punto di ingresso online o offline ha restituito ERROR_IO_PENDING. Non deve essere chiamato in nessun'altra volta. Un puntatore alla funzione SetResourceStatus viene passato al parametro SetResourceStatus all'implementazione della risorsa di Startup.

SetResourceStatus viene implementato da Monitoraggio risorse ed è simile alla funzione SetServiceStatus .

Aggiornare lo stato corrente di una risorsa ogni volta che è necessario dopo aver restituito ERROR_IO_PENDING. Se la risorsa si trova in uno degli stati in sospeso, aumentare i valori per i membri CheckPoint e WaitHint della struttura RESOURCE_STATUS e impostare il membro ResourceState su ClusterResourceOnlinePending o ClusterResourceOfflinePending prima di iniziare a chiamare SetResourceStatus. Chiamare SetResourceStatus fino a quando non si verifica una delle situazioni seguenti:

La risorsa viene inserita nello stato ClusterResourceOnline o ClusterResourceOffline .
Il limite di tempo archiviato nella proprietà PendingTimeout della risorsa è stato superato.

Non è necessario chiamare SetResourceStatus per impostare lo stato di una risorsa su uno stato in sospeso perché Monitoraggio risorse lo imposta automaticamente sullo stato in sospeso appropriato ogni volta che Online o Offline restituisce ERROR_IO_PENDING.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	resapi.h