PxeDhcpv6GetVendorOptionValue, fonction (wdspxe.h)

Article
08/27/2023

Récupère les valeurs d’option du champ OPTION_VENDOR_OPTS (17) d’un paquet DHCPv6.

Syntaxe

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Paramètres

[in] pPacket

Pointeur vers un paquet de réponse alloué avec la fonction PxePacketAllocate .

[in] uPacketLen

Longueur du paquet pointé vers le paramètre pReplyPacket .

[in] dwEnterpriseNumber

Numéro d’entreprise attribué au fournisseur de l’option par l’autorité IANA (Internet Assigned Numbers Authority).

Pour plus d’informations sur les numéros d’entreprise attribués, les développeurs doivent se référer au protocole de configuration d’hôte dynamique pour IPv6 (RFC 3315) géré par l’Internet Engineering Task Force (IETF).

[in] wOption

Option dont la valeur sera récupérée.

[in] uInstance

Index de base unique qui spécifie les instance du paramètre wOption à récupérer.

[out, optional] pwOptionLen

Adresse de WORD qui recevra la longueur de la valeur d’option.

[out, optional] ppOptionValue

Adresse de PVOID qui recevra l’adresse de la valeur d’option à l’intérieur du paquet.

Valeur retournée

Les valeurs de retour courantes sont répertoriées dans le tableau suivant. Pour tous les autres échecs, un code d’erreur Windows approprié est retourné.

Code/valeur de retour	Description
ERROR_SUCCESS 0 (0x0)	L’option a été trouvée et un pointeur vers la valeur a été retourné.
ERROR_FILE_NOT_FOUND 2 (0x2)	L’option n’a pas été trouvée.
ERROR_INVALID_DATA 13 (0xD)	Le paquet n’est pas un paquet DHCP valide. Ce test n’est pas aussi approfondi que les tests utilisés par la fonction PxeDhcpv6IsValid ; seuls la longueur du paquet et le cookie magique sont vérifiés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdspxe.h
Bibliothèque	WdsPxe.lib
DLL	WdsPxe.dll

Voir aussi

PxeDhcpv6GetOptionValue

PxePacketAllocate

Fonctions serveur des services de déploiement Windows

Partager via