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]

Voir aussi

Windows Fonctions du serveur des services de déploiement

PxeRegisterCallback

PxeSendReply

PxeProviderSetAttribute