Função MprInfoBlockAdd (mprapi.h)
A função MprInfoBlockAdd cria um novo cabeçalho idêntico a um cabeçalho existente com a adição de um novo bloco.
Sintaxe
DWORD MprInfoBlockAdd(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[in] DWORD dwItemSize,
[in] DWORD dwItemCount,
[in] LPBYTE lpItemData,
[out] LPVOID *lplpNewHeader
);
Parâmetros
[in] lpHeader
Ponteiro para o cabeçalho no qual adicionar o novo bloco.
[in] dwInfoType
Especifica o tipo de bloco a ser adicionado. Os tipos disponíveis dependem do transporte: IPv4, IPv6 ou IPX.
Windows Server 2008: Se dwInfoTYpe contiver IP_ROUTE_INFO, lpItemData deverá apontar para uma estrutura INTERFACE_ROUTE_INFO .
[in] dwItemSize
Especifica o tamanho de cada item no bloco a ser adicionado.
[in] dwItemCount
Especifica o número de itens de tamanho dwItemSize a serem copiados como dados para o novo bloco.
[in] lpItemData
Ponteiro para os dados do novo bloco. O tamanho em bytes desse buffer deve ser igual ao produto de dwItemSize e dwItemCount.
[out] lplpNewHeader
Ponteiro para uma variável de ponteiro que, no retorno bem-sucedido, aponta para o novo cabeçalho.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NO_ERROR.
Se a função falhar, o valor retornado será um dos valores a seguir.
| Valor | Descrição |
|---|---|
|
O parâmetro lpHeader, lplpNewHeader ou lpItemData é NULL ou um bloco do tipo dwInfoType já existe no cabeçalho. |
|
Falha na chamada. Use FormatMessage para recuperar a mensagem de erro que corresponde ao código de erro retornado. |
Comentários
Depois de adicionar um bloco de informações, obtenha o novo tamanho do cabeçalho de informações ao chamar MprInfoBlockQuerySize.
Requisitos
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mprapi.h |
| Biblioteca | Mprapi.lib |
| DLL | Mprapi.dll |