Função PxeProviderRegister (wdspxe.h)

  • Artigo

Registra um provedor com o sistema. Os provedores usam essa função durante a instalação para se registrar no sistema. No registro bem-sucedido, um identificador de chave do Registro é retornado que deve ser usado para armazenar informações de configuração.

Sintaxe

DWORD PXEAPI PxeProviderRegister(
  [in]  LPCWSTR       pszProviderName,
  [in]  LPCWSTR       pszModulePath,
  [in]  PXE_REG_INDEX Index,
  [in]  BOOL          bIsCritical,
  [out] PHKEY         phProviderKey
);

Parâmetros

[in] pszProviderName

Endereço de uma cadeia de caracteres terminada em nulo que especifica o nome de exibição do provedor. Esse nome é exibido para o usuário e deve ser exclusivo entre os provedores registrados.

[in] pszModulePath

Endereço de uma cadeia de caracteres terminada em nulo que especifica o caminho completo para a DLL do provedor.

[in] Index

Indexe na lista de provedores. Todos os provedores existentes são deslocados para baixo, se necessário. O administrador pode reorganizar os provedores conforme necessário, portanto, nenhuma suposição deve ser feita sobre a ordem dos provedores.

Valor Significado
PXE_REG_INDEX_TOP
0
 Adicione o provedor à parte superior da lista para ser o primeiro a receber solicitações de cliente.
PXE_REG_INDEX_BOTTOM
0xFFFFFFFF
 Adicione o provedor à parte inferior da lista.

[in] bIsCritical

Indica se o provedor é crítico. Se um provedor crítico falhar, o servidor WDS também falhará.

[out] phProviderKey

Endereço de um HKEY em que a configuração deve ser armazenada. O provedor receberá um identificador para essa mesma chave que o parâmetro hProviderKey para seu retorno de chamada PxeProviderInitialize .

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wdspxe.h
Biblioteca WdsPxe.lib
DLL WdsPxe.dll

Confira também

PxeProviderInitialize

PxeProviderUnRegister

Funções de servidor dos Serviços de Implantação do Windows