Função PFN_WEB_CORE_ACTIVATE

Inicia uma instância do Web Core hospedado.

Sintaxe

typedef HRESULT (*PFN_WEB_CORE_ACTIVATE)(  
   IN PCWSTR pszAppHostConfigFile,  
   IN PCWSTR pszRootWebConfigFile,  
   IN PCWSTR pszInstanceName  
);  

Parâmetros

pszAppHostConfigFile
Um ponteiro para uma cadeia de caracteres que contém o caminho de um arquivo de configuração.

pszRootWebConfigFile
Um ponteiro para uma cadeia de caracteres que contém o caminho de um arquivo de Web.config raiz. (Opcional)

pszInstanceName
Um ponteiro para uma cadeia de caracteres que contém o nome da instância que será usada para registro em log de eventos.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Descrição
S_OK	Indica que a operação foi bem-sucedida.
ERROR_SERVICE_ALREADY_RUNNING	Indica que uma instância do Web Core hospedado já está em execução no processo.
ERROR_INVALID_DATA	Indica que ocorreu um erro de configuração no arquivo de configuração.

Observação

Se a PFN_WEB_CORE_ACTIVATE função retornar uma mensagem ERROR_INVALID_DATA, o Visualizador de Eventos poderá conter detalhes adicionais sobre a causa da falha.

Comentários

A PFN_WEB_CORE_ACTIVATE função é um protótipo para o WebCoreActivate ponto de entrada DLL em Hwebcore.dll que é usado para iniciar o Web Core Hospedado. O processo que hospeda o núcleo da Web é necessário para fornecer o caminho de um arquivo de configuração que contém as configurações de todos os sites, o pool de aplicativos e assim por diante, que devem ser criados.

Observação

O Web Core Hospedado requer um arquivo de configuração que segue o design do arquivo ApplicationHost.config, exceto que o Hosted Web Core dá suporte a apenas um pool de aplicativos. Para obter mais informações sobre como criar um arquivo de configuração para seu aplicativo, consulte Passo a passo: criando um arquivo de configuração para o Web Core hospedado.

Essa função também requer o nome da instância do Web Core Hospedado que o IIS 7 usa quando registra eventos no Visualizador de Eventos. Opcionalmente, o processo de hospedagem pode fornecer o caminho de um arquivo de Web.config raiz que contém parâmetros adicionais.

Requisitos

Type	Descrição
Cliente	- IIS 7.0 no Windows Vista - IIS 7.5 no Windows 7 - IIS 8.0 no Windows 8 - IIS 10.0 no Windows 10
Servidor	- IIS 7.0 no Windows Server 2008 - IIS 7.5 no Windows Server 2008 R2 - IIS 8.0 no Windows Server 2012 - IIS 8.5 no Windows Server 2012 R2 - IIS 10.0 no Windows Server 2016
Produto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
parâmetro	Hwebcore.h

Consulte Também

Referência de API web core hospedada
Função PFN_WEB_CORE_SHUTDOWN