Compartilhar via


Função MprInfoBlockRemove (mprapi.h)

A função MprInfoBlockRemove cria um novo cabeçalho idêntico a um cabeçalho existente com um bloco especificado removido.

Sintaxe

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

Parâmetros

[in] lpHeader

Ponteiro para o cabeçalho do qual o bloco deve ser removido.

[in] dwInfoType

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

[out] lplpNewHeader

Ponteiro para uma variável de ponteiro que recebe 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
O parâmetro lpHeader é NULL ou nenhum bloco do tipo dwInfoType existe no cabeçalho.
ERROR_NOT_ENOUGH_MEMORY
A alocação de memória necessária para a execução bem-sucedida de MprInfoBlockRemove não pôde ser concluída.
Outros
Falha na chamada. Use FormatMessage para recuperar a mensagem de erro que corresponde ao código de erro retornado.

Comentários

Depois de remover 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

Confira também

FormatMessage

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

MprInfoBlockAdd

MprInfoBlockQuerySize