Partager via


Fonction MprInfoBlockRemove (mprapi.h)

La fonction MprInfoBlockRemove crée un nouvel en-tête identique à un en-tête existant avec un bloc spécifié supprimé.

Syntaxe

DWORD MprInfoBlockRemove(
  [in]  LPVOID lpHeader,
  [in]  DWORD  dwInfoType,
  [out] LPVOID *lplpNewHeader
);

Paramètres

[in] lpHeader

Pointeur vers l’en-tête à partir duquel le bloc doit être supprimé.

[in] dwInfoType

Spécifie le type de bloc à supprimer. Les types disponibles dépendent du transport : IP ou IPX.

[out] lplpNewHeader

Pointeur vers une variable de pointeur qui reçoit 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 a la valeur NULL ou aucun bloc de type dwInfoType n’existe dans l’en-tête.
ERROR_NOT_ENOUGH_MEMORY
L’allocation de mémoire requise pour une exécution réussie de MprInfoBlockRemove n’a pas pu être effectuée.
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 supprimé 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

Voir aussi

FormatMessage

Fonctions et en-têtes d’informations MprInfo

MprInfoBlockAdd

MprInfoBlockQuerySize