Função RxCeQueryAdapterStatus (rxce.h)

Artigo
02/07/2025

RxCeQueryAdapterStatus retorna a estrutura ADAPTER_STATUS para um determinado transporte em um buffer alocado por chamador.

Sintaxe

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Parâmetros

pTransport

Um ponteiro para o transporte RDBSS associado a um adaptador.

pAdapterStatus

Na entrada, esse parâmetro contém um ponteiro para o buffer alocado pelo chamador para manter o status do adaptador. Na saída quando essa chamada for bem-sucedida, o buffer contém o status do adaptador associado ao transporte RDBSS especificado.

Valor de retorno

RxCeQueryAdapterStatus retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro sobre falha:

Código de retorno	Descrição
STATUS_ADDRESS_NOT_ASSOCIATED	Um endereço do adaptador não está associado ao transporte RDBSS.
STATUS_INSUFFICIENT_RESOURCES	Falha na alocação de memória de pool nãopagada necessária para essa rotina.
STATUS_INVALID_PARAMETER	O parâmetro pTransport passado para essa rotina era inválido.

Observações

RxCeQueryAdapterStatus retorna uma estrutura ADAPTER_STATUS para um determinado transporte. Essa rotina é mais usada para obter o nome NetBIOS do adaptador.

RxCeQueryAdapterStatus chama TdiBuildQueryInformation com uma consulta TDI_QUERY_ADAPTER_STATUS.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	rxce.h (inclua Rxce.h)
IRQL	<= APC_LEVEL

Consulte também

ADAPTER_STATUS

RxCeQueryInformation

RxCeQueryTransportInformation

Compartilhar via