Compartilhar via


Função MprInfoBlockSet (mprapi.h)

O MprInfoBlockSet cria um novo cabeçalho idêntico a um cabeçalho existente com um bloco especificado modificado.

Sintaxe

DWORD MprInfoBlockSet(
  [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 modificar o bloco especificado.

[in] dwInfoType

Especifica o tipo de bloco a ser alterado. Os tipos disponíveis dependem do transporte: IP ou IPX.

[in] dwItemSize

Especifica o tamanho de cada item nos novos dados do bloco.

[in] dwItemCount

Especifica o número de itens de tamanho dwItemSize a serem copiados como os novos dados do bloco.

[in] lpItemData

Ponteiro para os novos dados do bloco. Isso deve apontar para um buffer com um tamanho (em bytes) 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
ERROR_INVALID_PARAMETER
Um (ou mais) parâmetros necessários é NULL ou nenhum bloco do tipo dwInfoType existe no cabeçalho.
Outros
Falha na chamada. Use FormatMessage para recuperar a mensagem de erro que corresponde ao código de erro retornado.

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

Confira também

FormatMessage

Funções e cabeçalhos de informações do MprInfo

MprInfoBlockAdd

MprInfoBlockRemove