Função MprInfoBlockFind (mprapi.h)

Artigo
03/15/2023

A função MprInfoBlockFind localiza um bloco especificado em um cabeçalho de informações e recupera informações sobre o bloco.

Sintaxe

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

Parâmetros

[in] lpHeader

Especifica o cabeçalho no qual localizar o bloco.

[in] dwInfoType

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

[out] lpdwItemSize

Ponteiro para uma variável DWORD que recebe o tamanho de cada item nos dados do bloco localizado. Esse parâmetro é opcional. Se esse parâmetro for NULL, o tamanho do item não será retornado.

[out] lpdwItemCount

Ponteiro para uma variável DWORD que recebe o número de itens de tamanho dwItemSize contidos nos dados do bloco. Esse parâmetro é opcional. Se esse parâmetro for NULL, a contagem de itens não será retornada.

[out] lplpItemData

Ponteiro para um ponteiro que, no retorno bem-sucedido, aponta para os dados do bloco localizado. Esse parâmetro é opcional. Se esse parâmetro for NULL, os dados não serão retornados.

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 lpInfoHeader é NULL.
ERROR_NOT_FOUND	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

Compartilhar via