PxeProviderRecvRequest fonction de rappel
Appelée lorsqu’une demande est reçue d’un client. Cette fonction est inscrite en appelant la fonction PxeRegisterCallback avec le paramètre CallbackType défini sur la _ _ _ demande de rappel PXE.
Syntaxe
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
);
Paramètres
-
hClientRequest [ dans]
-
Handle d’une demande reçue d’un client.
-
pPacket [ dans]
-
Pointeur vers la mémoire tampon qui contient le paquet reçu.
-
uPacketLen [ dans]
-
Longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre pPacket .
-
pLocalAddress [ dans]
-
Pointeur vers une structure d' _ adresse PXE qui contient l’adresse locale sur laquelle le paquet a été reçu.
-
pRemoteAddress [ dans]
-
Pointeur vers une structure d' _ adresse PXE qui contient l’adresse source du paquet.
-
Pacte [ à]
-
Spécifie l’action que le système doit effectuer.
Valeur Signification - Environnement
- PXE _ E _ NBP
- 1
Le fournisseur a répondu à un client avec un paquet de réponse DHCP standard qui contient un chemin d’accès au programme de démarrage réseau. Le retour de cette action signifie que le fournisseur a terminé la demande du client en appelant la fonction PxeSendReply au moins une fois. - Environnement
- PXE _ BA _ personnalisé
- 2
Le fournisseur a répondu à un client à l’aide d’une réponse personnalisée qui n’est pas conforme aux spécifications DHCP. Le retour de cette action signifie que le fournisseur a terminé la demande du client en appelant la fonction PxeSendReply au moins une fois. - Environnement
- PXE _ BA _ Ignorer
- 3
Le fournisseur ne souhaite pas traiter la demande du client et la demande ne doit pas être transmise au fournisseur suivant. Toutes les ressources associées à la demande du client sont libérées et la demande du client est ignorée. Les fournisseurs peuvent également utiliser cette valeur s’ils reconnaissent le client mais que la demande est incorrecte. - Environnement
- PXE _ BA a _ rejeté
- 4
Le fournisseur ne souhaite pas traiter la demande du client. Le système transmet la demande au fournisseur suivant dans la liste des fournisseurs inscrits. S’il s’agit du dernier fournisseur de la liste, toutes les ressources associées à la demande du client sont libérées et la demande du client est ignorée. -
pContext [ dans]
-
Valeur de contexte passée à la fonction PxeRegisterCallback .
Valeur retournée
Si le fournisseur a correctement traité la demande du client, le rappel doit retourner la _ réussite de l’erreur et l' _ _ action de démarrage PXE vers laquelle pointe le paramètre de Pacte contient l’action de démarrage appropriée pour cette demande. Si le fournisseur traitera la demande du client de manière asynchrone, le rappel doit retourner des _ e/s d’erreur _ en attente et appeler la fonction PxeAsyncRecvDone lorsque la demande du client a été traitée. En cas d’échec, un code d’erreur approprié doit être retourné et le système se poursuivra comme si l’action de démarrage _ _ rejetée par PXE BA avait été spécifiée.
Remarques
Le type de paquets détectés par un fournisseur peut être modifié à l’aide de la fonction PxeProviderSetAttribute .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Aucun pris en charge |
| Serveur minimal pris en charge |
Windows serveur 2008, Windows server 2003 avec les [ applications de bureau SP2 uniquement] |