Partilhar via

Atributos do campo

Atributos de campo são os atributos que podem ser aplicados a campos de uma matriz, estrutura, união ou matriz de caracteres:

Por exemplo, os atributos de campo são usados em conjunto com declarações de matriz para especificar o tamanho da matriz ou a parte da matriz que contém dados válidos. Isso é feito associando outro parâmetro, campo de estrutura ou uma expressão constante com a matriz.

O atributo [ignore] designa campos de ponteiro a serem ignorados durante o processo de empacotamento. Esse campo ignorado é definido como NULL no lado do recetor.

O MIDL fornece conforme, variável e matrizes abertas. Uma matriz é chamada de conformidade se seus limites são determinados em tempo de execução. O atributo [size_is] designa o limite superior no tamanho de alocação da matriz e o atributo[max_is ] designa o limite superior no valor de um índice de matriz válido. Para obter mais informações, consulte [matrizes].

Uma matriz é chamada de variação se seus limites são determinados em tempo de compilação, mas o intervalo de elementos transmitidos é determinado em tempo de execução. Uma matriz aberta (também chamada de matriz variável conformante) é uma matriz cujo limite superior e intervalo de elementos transmitidos são determinados em tempo de execução. Para determinar o intervalo de elementos transmitidos de uma matriz, a declaração de matriz deve incluir um atributo [length_is], [first_is]ou [last_is].

O atributo [length_is] designa o número de elementos de matriz a serem transmitidos e o atributo de [first_is] designa o índice do primeiro elemento de matriz a ser transmitido. O atributo [last_is] designa o índice do último elemento de matriz a ser transmitido.

O atributo [switch_is] field designa um discriminador sindical. Quando a união é um parâmetro de procedimento, o discriminador sindical deve ser outro parâmetro do mesmo procedimento. Quando o sindicato é um campo de uma estrutura, o discriminador deve ser outro campo da estrutura no mesmo nível do campo sindical. O discriminador deve ser umbooleano, char, int, ou enum tipo, ou um tipo que resolva para um desses tipos. Para obter mais informações, consulte Uniões não encapsuladas e [switch_is].

O atributo de campo[string ] designa que um caractere unidimensional ou matriz de bytes, ou um ponteiro para um fluxo de caracteres ou bytes terminado em zero, deve ser tratado como uma cadeia de caracteres. O atributo string aplica-se apenas a matrizes unidimensionais e ponteiros. O tipo de elemento é limitado a char, byte, wchar_tou um tipo nomeado que resolve para um desses tipos.

Para obter informações sobre o contexto no qual os atributos de campo aparecem, consulte Matrizes MIDL, Estruturas MIDLe Uniões MIDL.

 

 

  • Last updated on