Función MprInfoBlockAdd (mprapi.h)
La función MprInfoBlockAdd crea un nuevo encabezado idéntico a un encabezado existente con la adición de un nuevo bloque.
Sintaxis
DWORD MprInfoBlockAdd(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[in] DWORD dwItemSize,
[in] DWORD dwItemCount,
[in] LPBYTE lpItemData,
[out] LPVOID *lplpNewHeader
);
Parámetros
[in] lpHeader
Puntero al encabezado en el que se va a agregar el nuevo bloque.
[in] dwInfoType
Especifica el tipo de bloque que se va a agregar. Los tipos disponibles dependen del transporte: IPv4, IPv6 o IPX.
Windows Server 2008: Si dwInfoTYpe contiene IP_ROUTE_INFO, lpItemData debe apuntar a una estructura INTERFACE_ROUTE_INFO .
[in] dwItemSize
Especifica el tamaño de cada elemento del bloque que se va a agregar.
[in] dwItemCount
Especifica el número de elementos de tamaño dwItemSize que se van a copiar como datos para el nuevo bloque.
[in] lpItemData
Puntero a los datos del nuevo bloque. El tamaño en bytes de este búfer debe ser igual al producto de dwItemSize y dwItemCount.
[out] lplpNewHeader
Puntero a una variable de puntero que, al devolverse correctamente, apunta al nuevo encabezado.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los valores siguientes.
| Valor | Descripción |
|---|---|
|
El parámetro lpHeader, lplpNewHeader o lpItemData es NULL o ya existe un bloque de tipo dwInfoType en el encabezado. |
|
Se produjo un error en la llamada. Use FormatMessage para recuperar el mensaje de error correspondiente al código de error devuelto. |
Comentarios
Después de agregar un bloque de información, obtenga el nuevo tamaño del encabezado de información mediante una llamada a MprInfoBlockQuerySize.
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mprapi.h |
| Library | Mprapi.lib |
| Archivo DLL | Mprapi.dll |