PSTARTUP_ROUTINE função de retorno de chamada (resapi.h)
Carrega uma DLL de recurso, retornando uma estrutura que contém uma tabela de funções e um número de versão. O tipo PSTARTUP_ROUTINE define um ponteiro para essa função.
Sintaxe
PSTARTUP_ROUTINE PstartupRoutine;
DWORD PstartupRoutine(
[in] LPCWSTR ResourceType,
[in] DWORD MinVersionSupported,
[in] DWORD MaxVersionSupported,
[in] PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
[in] PLOG_EVENT_ROUTINE LogEvent,
[out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}
Parâmetros
[in] ResourceType
Tipo de recurso que está sendo iniciado.
[in] MinVersionSupported
Versão mínima da API de Recurso compatível com o serviço de Cluster.
[in] MaxVersionSupported
Versão máxima da API de Recurso compatível com o serviço de Cluster.
[in] SetResourceStatus
Ponteiro para uma função de retorno de chamada que a DLL de recurso deve chamar para atualizar seu status depois de retornar ERROR_IO_PENDING do Online ou Offline. Para obter mais informações, consulte SetResourceStatus.
[in] LogEvent
Ponteiro para uma função de retorno de chamada que a DLL de recurso deve chamar para relatar eventos para o recurso. Para obter mais informações , consulte LogEvent.
[out] FunctionTable
Ponteiro para uma estrutura CLRES_FUNCTION_TABLE que descreve a versão da API de Recurso e os nomes específicos para os pontos de entrada.
Valor retornado
| Valor/código retornado | Descrição |
|---|---|
|
A solicitação foi bem-sucedida. |
|
A DLL do recurso não dá suporte a uma versão que se enquadra no intervalo identificado pelos parâmetros MinVersionSupported e MaxVersionSupported . |
Se a operação não tiver sido bem-sucedida, a inicialização deverá retornar um dos códigos de erro do sistema.
Comentários
A função de ponto de entrada Inicialização retorna uma tabela de funções que descreve a versão de interface com suporte da API de Recurso e os pontos de entrada para todas as outras funções exigidas pela versão com suporte da API de Recurso.
Atualmente, há suporte apenas para a API de Recurso versão 1.0.
Se o recurso der suporte a mais de uma versão da API de Recurso, retorne uma tabela de funções para a versão mais recente. O número de versão deve ser menor ou igual ao parâmetro MaxVersionSupported . Se a versão da tabela de funções apontada pelo parâmetro FunctionTable não estiver dentro do intervalo, o recurso não poderá ser carregado com êxito.
Para obter mais informações, consulte Implementando a inicialização.
Exemplos
Consulte Implementando a inicialização.
Requisitos
| 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 |