Compartilhar via

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

Executa uma operação que se aplica a um recurso. O tipo PRESOURCE_CONTROL_ROUTINE define um ponteiro para essa função.

Sintaxe

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

Parâmetros

[in] Resource

Identificador de recurso do recurso afetado.

[in] ControlCode

Código de controle que representa a operação a ser executada. Para obter uma lista de valores válidos para o parâmetro ControlCode , consulte Códigos de controle de tipo de recurso.

[in, optional] InBuffer

Ponteiro para um buffer que contém dados a serem usados na operação. InBuffer poderá ser NULL se nenhum dado for necessário.

[in] InBufferSize

Tamanho, em bytes, do buffer apontado pelo InBuffer.

[out, optional] OutBuffer

Ponteiro para um buffer que contém dados resultantes da operação. OutBuffer poderá ser NULL se a operação não precisar retornar dados.

[in] OutBufferSize

Tamanho, em bytes, do espaço disponível apontado pelo OutBuffer.

[out] BytesReturned

Tamanho real, em bytes, dos dados resultantes da operação.

Retornar valor

Valor/código retornado Descrição
ERROR_SUCCESS
0
 A operação associada ao ControlCode foi concluída com êxito.
ERROR_INVALID_FUNCTION
1
 A DLL do recurso solicitou que o Monitor de Recursos executasse o processamento padrão (se houver) para ControlCode , além do processamento fornecido pela DLL (se houver).
ERROR_MORE_DATA
234 (0xEA)
 O tamanho alocado do OutBuffer era muito pequeno para conter os dados solicitados. BytesReturned indica o tamanho necessário. Sempre inclua o NULL de terminação ao calcular os tamanhos de bytes de cadeias de caracteres.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Indica que novos valores de propriedade para um recurso foram definidos no banco de dados de cluster, mas as propriedades ainda não entraram em vigor. Os novos valores de propriedade serão aplicados depois que o recurso for colocado offline e colocado online.
Código de erro
 A operação foi malsucedida.

Comentários

Alguns códigos de controle devem ser tratados pela DLL do recurso, enquanto outros devem ser deixados para o Monitor de Recursos. Para obter estratégias de implementação eficazes da função de ponto de entrada ResourceControl , consulte Implementando ResourceControl.

Exemplos

Confira Exemplos de DLL de recurso.

Requisitos

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

Confira também

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

  • Last updated on