Share via


OID_CO_GET_ADDRESSES

O OID_CO_GET_ADDRESSES OID é usado pelo cliente para fazer uma consulta ao gerenciador de chamadas. Essa consulta é feita em resposta ao gerenciador de chamadas que envia um OID_CO_ADDRESS_CHANGE para o cliente. Em resposta a essa consulta, o gerenciador de chamadas envia ao cliente uma lista de endereços formatada como uma estrutura CO_ADDRESS_LIST, definida da seguinte maneira:

typedef struct _CO_ADDRESS_LIST {
    ULONG       NumberOfAddressesAvailable;
    ULONG       NumberOfAddresses;
    CO_ADDRESS  AddressList;
} CO_ADDRESS_LIST, *PCO_ADDRESS_LIST;

Os membros dessa estrutura contêm as seguintes informações:

NumberOfAddressesAvailable
Especifica o número máximo de endereços na lista de endereços do gerenciador de chamadas. Independentemente do número real de endereços que o gerenciador de chamadas retorna ao cliente em AddressList, o tamanho do buffer em AddressList é sempre NumberOfAddresses Disponível multiplicado pelo tamanho do endereço, que é um tamanho fixo específico para o gerenciador de chamadas.

NumberOfAddresses
Especifica o número de endereços que o gerenciador de chamadas gravou em AddressList.

Addresslist
O endereço de alias é formatado como uma estrutura CO_ADDRESS, definida da seguinte maneira:

typedef struct _CO_ADDRESS {
    ULONG   AddressSize;
    UCHAR   Address[1];
} CO_ADDRESS, *PCO_ADDRESS;

Os membros dessa estrutura contêm as seguintes informações:

AddressSize
Especifica o tamanho em bytes da estrutura em Endereço .

Endereço
Especifica uma matriz de comprimento variável que contém a lista de endereços. O formato de endereço é específico para o protocolo de sinalização usado pelo gerenciador de chamadas.

O AddressList contém endereços de rede nos quais o host local pode ser acessado. O AddressList retornado a um cliente específico contém endereços comuns a todos os clientes, bem como todos os endereços que o próprio cliente adicionou à lista de endereços do gerenciador de chamadas com OID_CO_ADD_ADDRESS.

Requisitos

Versão: Windows Vista e cabeçalho posterior: Ntddndis.h (inclua Ndis.h)