PONLINE_V2_ROUTINE funzione di callback (resapi.h)

Articolo
08/25/2023

Contrassegna una risorsa come disponibile per l'uso. Il tipo PONLINE_V2_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PONLINE_V2_ROUTINE PonlineV2Routine;

DWORD PonlineV2Routine(
  [in]           RESID Resource,
  [out]          LPHANDLE EventHandle,
  [in]           DWORD OnlineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Parametri

[in] Resource

Identificatore di risorsa per la risorsa da rendere disponibile.

[out] EventHandle

In input EventHandle è NULL. Nell'output EventHandle contiene un handle per un oggetto di sincronizzazione non segnalato. La DLL della risorsa può segnalare questo handle in qualsiasi momento per segnalare un errore di risorsa a Monitoraggio risorse. EventHandle può anche essere impostato su NULL nell'output, che indica che la risorsa non supporta le notifiche degli eventi asincrone.

[in] OnlineFlags

Maschera di bit di flag che specificano le impostazioni per questa operazione. Questo parametro può essere impostato su uno o più dei valori seguenti:

CLUS_RESDLL_ONLINE_RECOVER_MONITOR_STATE (0x00000001)

Monitorare lo stato della risorsa se la risorsa viene ripristinata da un errore.

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

Eseguire l'operazione anche se la risorsa indica che deve essere bloccata.

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

Se la risorsa genera un errore, restituirla al nodo di origine.

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

Impostare lo stato della risorsa su online.

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

Eseguire l'operazione anche se si verifica un errore di rete.

[in, optional] InBuffer

Puntatore a un buffer contenente i dati per l'operazione; in caso contrario , NULL se l'operazione non richiede dati.

[in] InBufferSize

Dimensione in byte del parametro InBuffer .

[in] Reserved

Riservato.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione ha avuto esito positivo e la risorsa è online.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	La risorsa è stata arbitrata con altri sistemi e uno degli altri sistemi ha vinto l'arbitrato. Solo le risorse che supportano il quorum restituiscono questo valore.
ERROR_IO_PENDING 997 (0x3E5)	La richiesta è in sospeso e un thread è stato attivato per elaborare la richiesta online.

Se l'operazione non è riuscita per altri motivi, viene restituito un codice di errore di sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2012 R2
Piattaforma di destinazione	Windows
Intestazione	resapi.h

Vedi anche

Funzioni di Entry-Point DLL delle risorse