MprInfoBlockAdd, fonction (mprapi.h)
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 |
|---|---|
|
Le paramètre lpHeader, lplpNewHeader ou lpItemData est NULL, ou un bloc de type dwInfoType existe déjà dans l’en-tête. |
|
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 |