Compartilhar via


POFFLINE_V2_ROUTINE função de retorno de chamada (resapi.h)

Marca um recurso como indisponível para uso após a conclusão do processamento da limpeza. O tipo POFFLINE_V2_ROUTINE define um ponteiro para essa função.

Sintaxe

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
)
{...}

Parâmetros

[in] Resource

Um identificador de recurso para o recurso a ser colocado offline.

[in, optional] DestinationNodeName

O nome do nó que deve conter o recurso quando a operação for concluída.

[in] OfflineFlags

Uma máscara de bits de sinalizadores que especificam configurações para essa operação. Esse parâmetro pode ser definido como um ou mais dos seguintes valores:

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

Execute a operação mesmo que o recurso indique que ela deve ser bloqueada.

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

Se o recurso apresentar um erro, retorne-o ao nó de origem.

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

Enfileira a operação se ela for atrasada por uma DLL de recurso e, em seguida, repita a operação até que ela seja concluída ou cancelada pelo cliente.

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

Indique que o recurso sofreu um erro e está retornando para o nó de origem.

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

Indique que houve uma falha inserida.

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

Execute a operação mesmo que haja um erro de rede.

Windows Server 2012: não há suporte para esse valor antes de Windows Server 2012 R2.

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

Não atualize o estado persistente do recurso.

Windows Server 2012 R2 e Windows Server 2012: não há suporte para esse valor antes do Windows Server 2016.

[in, optional] InBuffer

Um ponteiro para um buffer que contém dados para a operação; caso contrário , NULL se a operação não exigir dados.

[in] InBufferSize

O tamanho do parâmetro InBuffer , em bytes.

[in] Reserved

Reservado.

Retornar valor

Valor/código retornado Descrição
ERROR_SUCCESS
0
A solicitação foi concluída com êxito e o recurso está offline.
ERROR_IO_PENDING
997 (0x3E5)
A solicitação ainda está pendente e um thread foi ativado para processar a solicitação offline.
 

Se a operação não tiver sido bem-sucedida por outros motivos, essa função retornará um dos códigos de erro do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho resapi.h

Confira também

Funções de ponto de entrada da DLL do recurso