MprInfoBlockAdd, fonction (mprapi.h)

Article
08/24/2023

La fonction MprInfoBlockAdd crée un en-tête identique à un en-tête existant avec l’ajout d’un nouveau bloc.

Syntaxe

DWORD MprInfoBlockAdd(
  [in]  LPVOID lpHeader,
  [in]  DWORD  dwInfoType,
  [in]  DWORD  dwItemSize,
  [in]  DWORD  dwItemCount,
  [in]  LPBYTE lpItemData,
  [out] LPVOID *lplpNewHeader
);

Paramètres

[in] lpHeader

Pointeur vers l’en-tête dans lequel ajouter le nouveau bloc.

[in] dwInfoType

Spécifie le type de bloc à ajouter. Les types disponibles dépendent du transport : IPv4, IPv6 ou IPX.

Windows Server 2008 : Si dwInfoTYpe contient IP_ROUTE_INFO, lpItemData doit pointer vers une structure INTERFACE_ROUTE_INFO .

[in] dwItemSize

Spécifie la taille de chaque élément du bloc à ajouter.

[in] dwItemCount

Spécifie le nombre d’éléments de taille dwItemSize à copier en tant que données pour le nouveau bloc.

[in] lpItemData

Pointeur vers les données du nouveau bloc. La taille en octets de cette mémoire tampon doit être égale au produit de dwItemSize et dwItemCount.

[out] lplpNewHeader

Pointeur vers une variable pointeur qui, en cas de retour réussi, pointe vers le nouvel en-tête.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’une des valeurs suivantes.

Valeur	Description
ERROR_INVALID_PARAMETER	Le paramètre lpHeader, lplpNewHeader ou lpItemData est NULL, ou un bloc de type dwInfoType existe déjà dans l’en-tête.
Autres	L'appel a échoué. Utilisez FormatMessage pour récupérer le message d’erreur qui correspond au code d’erreur retourné.

Notes

Après avoir ajouté un bloc d’informations, obtenez la nouvelle taille de l’en-tête d’informations en appelant MprInfoBlockQuerySize.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll