Função GetFrameSourceAddress

A função GetFrameSourceAddress recupera o endereço de origem de um quadro.

Sintaxe

DWORD WINAPI GetFrameSourceAddress(
   HFRAME    hFrame,
   LPADDRESS lpAddress,
   DWORD     AddressType,
   DWORD     Flags
);

Parâmetros

hFrame

Um identificador para o quadro para o qual obter um ponteiro.

Lpaddress

Um buffer de retorno que armazena o endereço de origem do quadro.

AddressType

O tipo de endereço pesquisado, como ADDRESS_TYPE_ETHERNET ou ADDRESS_TYPE_IP.

Sinalizadores

Os sinalizadores usados para modificar os dados de endereço de origem retornados.

Valor	Significado
ADDRESSTYPE_FLAGS_NORMALIZE	Cancela o roteamento e agrupar BITs.
ADDRESSTYPE_FLAGS_BIT_REVERSE	Converte os endereços de rede do anel de token de volta ao normal.

Valor retornado

Se a função for bem-sucedida, o valor lpAddress será válido e o valor retornado será BHERR_SUCCESS.

Se a função não for bem-sucedida, o valor retornado será um código de erro.

Código de retorno	Descrição
BHERR_PROTOCOL_NOT_FOUND	O protocolo especificado pelo parâmetro AddressType é inválido para o quadro.
BHERR_INVALID_HFRAME	O valor do parâmetro hFrame é inválido.

Comentários

Um tipo de endereço de ADDRESS_TYPE_FIND_HIGHEST é permitido. Quando esse tipo de endereço é usado, a função pesquisa o endereço IPX, XNS, IP ou VINES antes de retornar o endereço ETHERNET, TOKENRING ou FDDI. Essa abordagem é útil para protocolos e ambientes nos quais duas NICs podem ser multiplexadas em um único endereço de servidor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Netmon.h
Biblioteca	Nmapi.lib
DLL	Nmapi.dll