Fonction MprInfoBlockFind (mprapi.h)

La fonction MprInfoBlockFind localise un bloc spécifié dans un en-tête d’informations et récupère des informations sur le bloc.

Syntaxe

DWORD MprInfoBlockFind(
  [in]  LPVOID  lpHeader,
  [in]  DWORD   dwInfoType,
  [out] LPDWORD lpdwItemSize,
  [out] LPDWORD lpdwItemCount,
  [out] LPBYTE  *lplpItemData
);

Paramètres

[in] lpHeader

Spécifie l’en-tête dans lequel localiser le bloc.

[in] dwInfoType

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

[out] lpdwItemSize

Pointeur vers une variable DWORD qui reçoit la taille de chaque élément dans les données du bloc situé. Ce paramètre est facultatif. Si ce paramètre a la valeur NULL, la taille de l’élément n’est pas retournée.

[out] lpdwItemCount

Pointeur vers une variable DWORD qui reçoit le nombre d’éléments de taille dwItemSize contenus dans les données du bloc. Ce paramètre est facultatif. Si ce paramètre a la valeur NULL, le nombre d’éléments n’est pas retourné.

[out] lplpItemData

Pointeur vers un pointeur qui, en cas de retour réussi, pointe vers les données du bloc situé. Ce paramètre est facultatif. Si ce paramètre a la valeur NULL, les données ne sont pas retournées.

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 lpInfoHeader est NULL.
ERROR_NOT_FOUND	Aucun bloc de type dwInfoType n’existe 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é.

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