Partager via


PxeDhcpv6GetVendorOptionValue, fonction (wdspxe.h)

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