Função de retorno de chamada PxeProviderRecvRequest
Chamado quando uma solicitação é recebida de um cliente. Essa função é registrada chamando a função PxeRegisterCallback com o parâmetro CallbackType definido como PXE_CALLBACK_RECV_REQUEST.
Sintaxe
DWORD PXEAPI PxeProviderRecvRequest(
_In_ HANDLE hClientRequest,
_In_ PVOID pPacket,
_In_ ULONG uPacketLen,
_In_ PXE_ADDRESS *pLocalAddress,
_In_ PXE_ADDRESS *pRemoteAddress,
_Out_ PXE_BOOT_ACTION pAction,
_In_ PVOID pContext
);
Parâmetros
-
hClientRequest [in]
-
Manipular para uma solicitação recebida de um cliente.
-
pPacket [in]
-
Ponteiro para o buffer de memória que contém o pacote recebido.
-
uPacketLen [in]
-
Comprimento, em bytes, do buffer apontado pelo parâmetro pPacket .
-
pLocalAddress [in]
-
Ponteiro para uma estrutura PXE_ADDRESS que contém o endereço local no qual o pacote foi recebido.
-
pRemoteAddress [in]
-
Ponteiro para uma estrutura PXE_ADDRESS que contém o endereço de origem do pacote.
-
pAction [out]
-
Especifica a ação que o sistema deve executar.
Valor Significado - PXE_BA_NBP
- 1
O provedor respondeu a um cliente com um pacote de resposta DHCP padrão que contém um caminho para o Programa de Inicialização de Rede. Retornar essa ação significa que o provedor concluiu com êxito a solicitação do cliente chamando a função PxeSendReply pelo menos uma vez. - PXE_BA_CUSTOM
- 2
O provedor respondeu a um cliente usando uma resposta personalizada que não está em conformidade com as especificações de DHCP. Retornar essa ação significa que o provedor concluiu com êxito a solicitação do cliente chamando a função PxeSendReply pelo menos uma vez. - PXE_BA_IGNORE
- 3
O provedor não deseja atender à solicitação do cliente e a solicitação não deve ser passada para o próximo provedor. Todos os recursos associados à solicitação do cliente são liberados e a solicitação do cliente é ignorada. Os provedores também poderão usar esse valor se reconhecerem o cliente, mas a solicitação tiver sido malformada. - PXE_BA_REJECTED
- 4
O provedor não deseja atender à solicitação do cliente. O sistema passa a solicitação para o próximo provedor na lista de provedores registrados. Se esse foi o último provedor na lista, todos os recursos associados à solicitação do cliente serão liberados e a solicitação do cliente será ignorada. -
pContext [in]
-
Valor de contexto passado para a função PxeRegisterCallback .
Valor retornado
Se o provedor tiver processado a solicitação do cliente com êxito, o retorno de chamada deverá retornar ERROR_SUCCESS e o PXE_BOOT_ACTION apontado pelo parâmetro pAction conterá a ação de inicialização apropriada para essa solicitação. Se o provedor processar a solicitação do cliente de forma assíncrona, o retorno de chamada deverá retornar ERROR_IO_PENDING e chamar a função PxeAsyncRecvDone quando a solicitação do cliente for processada. Em caso de falha, um código de erro apropriado deve ser retornado e o sistema continuará como se a PXE_BA_REJECTED ação de inicialização fosse especificada.
Comentários
O tipo de pacotes vistos por um provedor pode ser alterado com a função PxeProviderSetAttribute .
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] |