Compartilhar via


estrutura RADIUS_ATTRIBUTE_ARRAY (authif.h)

Nota O IAS (Serviço de Autenticação da Internet) foi renomeado como NPS (Servidor de Política de Rede) a partir do Windows Server 2008. O conteúdo deste tópico se aplica ao IAS e ao NPS. Em todo o texto, o NPS é usado para se referir a todas as versões do serviço, incluindo as versões originalmente conhecidas como IAS.
 
A estrutura RADIUS_ATTRIBUTE_ARRAY representa uma matriz de atributos.

Sintaxe

typedef struct _RADIUS_ATTRIBUTE_ARRAY {
  DWORD                  cbSize;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This, const RADIUS_ATTRIBUTE *pAttr)                 * )Add;
  const RADIUS_ATTRIBUTE  )(const _RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex) *(*AttributeAt;
  DWORD()(const _RADIUS_ATTRIBUTE_ARRAY *This)                 * GetSize;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex, const RADIUS_ATTRIBUTE *pAttr)                 * )InsertAt;
  DWORD()(_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex)                 * RemoveAt;
  DWORD((_RADIUS_ATTRIBUTE_ARRAY *This,DWORD dwIndex, const RADIUS_ATTRIBUTE *pAttr)                 * )SetAt;
} RADIUS_ATTRIBUTE_ARRAY, *PRADIUS_ATTRIBUTE_ARRAY;

Membros

cbSize

Especifica o tamanho da estrutura.

Add

Ponteiro para a função Add fornecida pelo NPS. O NPS define o valor do membro.

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos à qual acrescentar o atributo especificado.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

pAttr

Ponteiro para uma estrutura RADIUS_ATTRIBUTE para o atributo a ser acrescentado à matriz.

AttributeAt

Ponteiro para a função AttributeAt fornecida pelo NPS. O NPS define o valor do membro.

A função AttributeAt retorna um ponteiro const para o atributo especificado dentro da matriz.

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos da qual recuperar o atributo especificado.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

dwIndex

Especifica o índice do atributo a ser recuperado. A função retornará NULL se esse índice estiver fora do intervalo.

Use a função GetSize para determinar o tamanho da matriz. O maior índice é um menor que o tamanho da matriz.

GetSize

Ponteiro para a função GetSize fornecida pelo NPS. O NPS define o valor do membro.

A função GetSize retorna o tamanho da matriz de atributos.

A função GetSize retorna o tamanho da matriz de atributos, não o maior índice. Como as matrizes de atributo usam índices baseados em zero, o tamanho da matriz é um maior que o maior índice.

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos para os quais recuperar o tamanho.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

InsertAt

Ponteiro para a função InsertAt fornecida pelo NPS. O NPS define o valor do membro.

A função InsertAt insere o atributo especificado no índice especificado na matriz.

Quando a função InsertAt insere um novo atributo na matriz, ela incrementa o índice do atributo pré-existente nesse índice. Da mesma forma, ele incrementa o índice de quaisquer atributos pré-existentes em índices mais altos.

Para acrescentar um atributo ao final da matriz de atributos, use a função Add .

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos na qual inserir o atributo especificado.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

dwIndex

Especifica o índice no qual inserir o atributo especificado.

Use a função GetSize para determinar o tamanho da matriz. O maior índice é um menor que o tamanho da matriz.

pAttr

Ponteiro para uma estrutura RADIUS_ATTRIBUTE para o atributo a ser inserido na matriz.

RemoveAt

Ponteiro para a função RemoveAt fornecida pelo NPS. O NPS define o valor do membro.

A função RemoveAt remove o atributo no índice especificado na matriz.

Quando a função RemoveAt remove um atributo da matriz, ela diminui o índice de quaisquer atributos pré-existentes em índices mais altos.

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos da qual remover o atributo especificado.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

dwIndex

Especifica o índice do atributo a ser removido.

Use a função GetSize para determinar o tamanho da matriz. O maior índice é um menor que o tamanho da matriz.

SetAt

Ponteiro para a função SetAt fornecida pelo NPS. O NPS define o valor do membro.

A função SetAt substitui o atributo no índice especificado pelo atributo especificado.

Esse

Ponteiro para a estrutura RADIUS_ATTRIBUTE_ARRAY que representa a matriz de atributos que contém o atributo a ser substituído.

As funções GetRequest e GetResponse retornam ponteiros para estruturas RADIUS_ATTRIBUTE_ARRAY .

dwIndex

Especifica o índice do atributo a ser substituído.

Use a função GetSize para determinar o tamanho da matriz. O maior índice é um menor que o tamanho da matriz.

pAttr

Ponteiro para uma estrutura RADIUS_ATTRIBUTE . O atributo representado por essa estrutura substitui o atributo no índice especificado.

Comentários

A DLL de extensão não deve modificar essa estrutura. As alterações na matriz de atributos devem ser feitas chamando as funções fornecidas como membros dessa estrutura.

Essa estrutura é usada por DLLs de extensão que exportam RadiusExtensionProcess2. As funções que adicionam atributos à matriz:

AdicioneInsertAt copie o conteúdo da estrutura de RADIUS_ATTRIBUTE fornecida pelo chamador. Portanto, as DLLs de extensão que exportam RadiusExtensionProcess2 não precisam exportar RadiusExtensionFreeAttributes.

Essa estrutura é retornada pelas funções GetRequest e GetResponse.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008
Cabeçalho authif.h

Confira também

Sobre extensões do NPS

Referência de extensões do NPS

Estruturas de extensões do NPS

RADIUS_EXTENSION_CONTROL_BLOCK

RadiusExtensionProcess2