Compartilhar via


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

Marca um recurso como disponível para uso. O tipo PONLINE_V2_ROUTINE define um ponteiro para essa função.

Sintaxe

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

Parâmetros

[in] Resource

Um identificador de recurso para o recurso a ser disponibilizado.

[out] EventHandle

Na entrada, EventHandle é NULL. Na saída, EventHandle contém um identificador para um objeto de sincronização não sinalizado. A DLL do recurso pode sinalizar esse identificador a qualquer momento para relatar uma falha de recurso ao Monitor de Recursos. EventHandle também pode ser definido como NULL na saída, o que indica que o recurso não dá suporte a notificações de evento assíncronas.

[in] OnlineFlags

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

Monitore o estado do recurso se o recurso estiver se recuperando de um erro.

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

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

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

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

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

Defina o status do recurso como online.

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

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

[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 operação foi bem-sucedida e o recurso está online.
ERROR_RESOURCE_NOT_AVAILABLE
5006 (0x138E)
O recurso foi arbitrado com alguns outros sistemas, e um dos outros sistemas ganhou a arbitragem. Somente recursos compatíveis com quorum retornam esse valor.
ERROR_IO_PENDING
997 (0x3E5)
A solicitação está pendente e um thread foi ativado para processar a solicitação online.
 

Se a operação não tiver sido bem-sucedida por outros motivos, um código de erro do sistema será retornado.

Requisitos

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

Confira também

Funções de Entry-Point de DLL de recurso