POFFLINE_V2_ROUTINE funzione di callback (resapi.h)

Articolo
03/05/2024

Contrassegna una risorsa come non disponibile per l'uso al termine dell'elaborazione della pulizia. Il tipo POFFLINE_V2_ROUTINE definisce un puntatore a questa funzione.

Sintassi

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Parametri

[in] Resource

Identificatore di risorsa per la risorsa da portare offline.

[in, optional] DestinationNodeName

Nome del nodo che deve contenere la risorsa al termine dell'operazione.

[in] OfflineFlags

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_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

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

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

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

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

Accodare l'operazione se è ritardata da una DLL di risorse e quindi ripetere l'operazione fino al completamento o all'annullamento dal client.

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

Indicare che la risorsa ha riscontrato un errore e che viene restituito al nodo di origine.

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

Indicare che si è verificato un errore incorporato.

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

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

Windows Server 2012: questo valore non è supportato prima di Windows Server 2012 R2.

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

Non aggiornare lo stato permanente della risorsa.

Windows Server 2012 R2 e Windows Server 2012: questo valore non è supportato prima della Windows Server 2016.

[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	La richiesta è stata completata correttamente e la risorsa è offline.
ERROR_IO_PENDING 997 (0x3E5)	La richiesta è ancora in sospeso e un thread è stato attivato per elaborare la richiesta offline.

Se l'operazione non è riuscita per altri motivi, questa funzione restituisce uno dei codici di errore di sistema.

Requisiti

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

Vedi anche

Funzioni del punto di ingresso della DLL delle risorse

Condividi tramite