atributo nocode
O atributo [nocode] é usado em cabeçalhos ACF ou com funções individuais para impedir a geração de código stub do cliente.
[
nocode
[ , ACF-interface-attributes ]
]
interface interface-name
{
[ include filename-list ; ]
[ typedef [type-attribute-list] typename; ]
[ [ nocode [ , ACF-function-attributes ] ] function-name (
[ ACF-parameter-attributes ] parameter-name ;
...);
]
...
}
Parâmetros
-
ACF-interface-attributes
-
Especifica uma lista de um ou mais atributos que se aplicam à interface como um todo. Os atributos válidos incluem [auto_handle] ou [implicit_handle] e [código] ou [nocode]. Quando dois ou mais atributos de interface estão presentes, eles devem ser separados por vírgulas.
-
interface-name
-
Especifica o nome da interface. No modo de compatibilidade de DCE, o nome da interface deve corresponder ao nome da interface especificada no arquivo IDL. Quando você usa a opção /acf do compilador MIDL, o nome da interface no ACF e o nome da interface no arquivo IDL podem ser diferentes.
-
filename-list
-
Especifica uma lista de um ou mais nomes de arquivo de cabeçalho da linguagem C, separados por vírgulas. O nome completo do arquivo, incluindo a extensão, deve ser fornecido.
-
type-attribute-list
-
Especifica uma lista de um ou mais atributos, separados por vírgulas, que se aplicam ao tipo especificado. Os atributos de tipo válidos incluem [allocate].
-
typename
-
Especifica um tipo definido no arquivo IDL. Atributos de tipo no ACF só podem ser aplicados a tipos definidos anteriormente no arquivo IDL.
-
ACF-function-attributes
-
Especifica atributos que se aplicam à função como um todo, como [comm_status]. Os atributos de função são colocados entre colchetes. Separe vários atributos de função com vírgulas.
-
function-name
-
Especifica o nome da função conforme definido no arquivo IDL.
-
ACF-parameter-attributes
-
Especifica atributos ACF que se aplicam a um parâmetro. Observe que zero ou mais atributos podem ser aplicados ao parâmetro . Separe vários atributos de parâmetro com vírgulas. Os atributos de parâmetro ACF são colocados entre colchetes.
-
parameter-name
-
Especifica um parâmetro da função conforme definido no arquivo IDL. Cada parâmetro para a função deve ser especificado na mesma sequência e usando o mesmo nome definido no arquivo IDL.
Comentários
O atributo [nocode] pode aparecer no cabeçalho ACF ou pode ser aplicado a uma função individual.
Quando o atributo [nocode] aparece no cabeçalho ACF, o código stub do cliente não é gerado para nenhuma função remota, a menos que tenha o atributo de função [code] . Você pode substituir o atributo [nocode] no cabeçalho de uma função individual especificando o atributo [code] como um atributo de função.
Quando o atributo [nocode] aparece na lista de atributos da função, nenhum código stub do cliente é gerado para a função.
O código stub do cliente não é gerado quando:
- O cabeçalho ACF inclui o atributo [nocode] .
- O atributo [nocode] é aplicado à função .
- O atributo [local] aplica-se à função no arquivo de interface.
[código] ou [nocode] pode aparecer na lista de atributos de uma função e a que você escolher pode aparecer exatamente uma vez.
O atributo [nocode] é ignorado quando stubs de servidor são gerados. Não é possível aplicá-lo ao gerar stubs de servidor no modo de compatibilidade de DCE.
Confira também