Compartilhar via


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

Abre um recurso. O tipo POPEN_ROUTINE define um ponteiro para essa função.

Sintaxe

POPEN_ROUTINE PopenRoutine;

RESID PopenRoutine(
  [in] LPCWSTR ResourceName,
  [in] HKEY ResourceKey,
  [in] RESOURCE_HANDLE ResourceHandle
)
{...}

Parâmetros

[in] ResourceName

Nome do recurso a ser aberto.

[in] ResourceKey

Chave de banco de dados de cluster para o cluster que inclui o recurso representado por ResourceName.

[in] ResourceHandle

Identificador a ser passado para a função de retorno de chamada SetResourceStatus na função de ponto de entrada Inicialização .

Valor retornado

Se a operação tiver sido bem-sucedida, Open retornará um identificador de recurso (RESID).

Se a operação não tiver sido bem-sucedida, Open retornará NULL. Chame SetLastError para especificar que ocorreu um erro.

Comentários

A função Abrir ponto de entrada abre um recurso com o nome identificado pelo parâmetro ResourceName e retorna seu identificador de recurso. O identificador de recurso pode ser usado em chamadas futuras para outros pontos de entrada da API de Recurso para identificar o recurso.

Nunca feche o identificador representado pelo parâmetro ResourceHandle ou use-o para qualquer finalidade diferente de passá-lo para o Monitor de Recursos por meio da função de retorno de chamada LogEvent ou da função de retorno de chamada SetResourceStatus .

Para obter estratégias de implementação eficazes da função abrir ponto de entrada, consulte Implementando Open.

Exemplos

Confira Exemplos de DLL de recurso.

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

Confira também

Logevent

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

SetResourceStatus