Atributos de comprimento, tamanho e direção
Ao passar matrizes entre o cliente e o servidor, os atributos relacionados ao tamanho [max_is] e [size_is] determinam quantos elementos de matriz o stub do servidor aloca. Os atributos relacionados ao comprimento [length_is], [first_is] e [last_is] determinam quantos elementos são transmitidos ao servidor e ao cliente.
Atributos direcionais diferentes podem ser aplicados a parâmetros. No entanto, algumas combinações de atributos direcionais podem causar erros. Por exemplo, suponha que você esteja escrevendo uma interface que especifica um procedimento com dois parâmetros, uma matriz e o comprimento transmitido da matriz. O termo dir_attr refere-se ao atributo direcional aplicado ao parâmetro como:
Proc1(
[dir_attr] short *plength;
[dir_attr, length_is(pLength)] short array[MAX_SIZE]);
O comportamento do compilador MIDL para cada combinação de atributos direcionais é descrito na tabela a seguir.
| Array | Parâmetro length | Ações de stub durante a chamada de cliente para servidor | Ações de stub no retorno do servidor para o cliente |
|---|---|---|---|
| [in] | [in] | Transmita o comprimento e o número de elementos indicados pelo parâmetro . | Nenhum dado transmitido. |
| [in] | [out] | Não é legal; Erro do compilador MIDL. | Não é legal; Erro do compilador MIDL. |
| [in] | [in, out] | Transmita o comprimento e o número de elementos indicados pelo parâmetro length. | Transmita somente o comprimento. |
| [out] | [in] | Transmita o comprimento. Se o tamanho da matriz for fixo, aloque o tamanho da matriz no servidor, mas não transmita nenhum elemento. Se o tamanho da matriz não estiver associado, não será legal: erro do compilador MIDL. |
Transmita o número de elementos indicados pelo comprimento. Observe que o comprimento pode ser alterado e pode ter um valor diferente do valor no cliente. Não transmita o comprimento. |
| [out] | [out] | Aloque espaço para o parâmetro de comprimento no servidor, mas não transmita o parâmetro . Se o tamanho da matriz for fixo, aloque o tamanho da matriz no servidor, mas não transmita nenhum elemento. Se o tamanho da matriz não for fixo, não será legal: erro do compilador MIDL. |
Transmita o comprimento e o número de elementos indicados pelo comprimento, conforme definido pelo aplicativo do servidor. |
| [out] | [in, out] | Transmita o parâmetro de comprimento. Se o tamanho da matriz estiver associado, aloque o tamanho da matriz no servidor, mas não transmita nenhum elemento. Se o tamanho da matriz não estiver associado, não será legal: erro do compilador MIDL. |
Transmita o comprimento. Transmita o número de elementos de matriz indicados pelo comprimento. |
| [in, out] | [in] | Transmita o comprimento e o número de elementos indicados pelo parâmetro . | Não transmita o comprimento. Transmita o número de elementos indicados pelo comprimento. Observe que o comprimento pode ser alterado e pode ter um valor diferente do valor original no cliente. |
| [in, out] | [out] | Não é legal; Erro do compilador MIDL. | Não é legal; Erro do compilador MIDL. |
| [in, out] | [in, out] | Transmita o comprimento e o número de elementos indicados pelo parâmetro . | Transmita o comprimento e o número de elementos indicados pelo parâmetro . |
Em geral, você não deve modificar os parâmetros de tamanho ou comprimento no lado do servidor. Se você alterar o parâmetro de comprimento, poderá criar memória órfã. Para obter mais informações, consulte Memory Orphaning.