PxeDhcpv6GetOptionValue, fonction (wdspxe.h)

Récupère une valeur d’option à partir d’un paquet DHCPv6.

Syntaxe

DWORD PXEAPI PxeDhcpv6GetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            WORD  wOption,
  [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] uInstance

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

[in] wOption

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

[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 DHCPv6 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

PxeDhcpv6AppendOption

PxeDhcpv6GetVendorOptionValue

PxeDhcpv6IsValid

PxePacketAllocate

Fonctions serveur des services de déploiement Windows