atributo auto_handle
O atributo ACF [auto_handle] direciona o stub para estabelecer automaticamente a associação para uma função que não tem um parâmetro de identificador de associação explícito.
Observação
Esse atributo é obsoleto e não tem mais suporte. O uso do comutador /robust é recomendado.
[
auto_handle [, interface-attribute-list]
]
interface interface-name
{
interface-definition
}
Parâmetros
-
interface-attribute-list
-
Especifica zero ou mais atributos que se aplicam à interface como um todo, como código ou nocode. Separar atributos de interface com vírgulas.
-
interface-name
-
Especifica o nome da interface.
-
interface-definition
-
Especifica instruções IDL que formam a definição da interface .
Comentários
O atributo [auto_handle] aparece no cabeçalho da interface do ACF. Ele também aparece no cabeçalho da interface do arquivo IDL quando você especifica a opção /app_config do compilador MIDL.
Quando o cliente chama uma função que usa associação automática e nenhuma associação a um servidor existe, o stub estabelece automaticamente a associação. A associação é reutilizado para chamadas subsequentes para outras funções na interface que usam a associação automática. O programa de aplicativo cliente não precisa declarar ou executar nenhum processamento relacionado ao identificador de associação.
Quando o ACF não está presente ou não inclui o atributo [implicit_handle] , o compilador MIDL usa [auto_handle] e emite uma mensagem informativa. O compilador MIDL também usa [auto_handle], se necessário, para estabelecer a associação inicial para um [context_handle].
O atributo [auto_handle] só poderá ocorrer se o atributo [implicit_handle] ou [explicit_handle] não ocorrer. O atributo [auto_handle] pode ocorrer no cabeçalho da interface ACF ou IDL no máximo uma vez.
Observação
Você não poderá usar a associação automática (com o atributo [auto_handle] ou por padrão) se estiver processando dados por meio de pipes.
Exemplos
[
auto_handle
]
interface MyInterface
{
/* Interface definition goes here*/
}
[
auto_handle,
code
]
interface MyInterface
{
/* Interface definition goes here*/
}
Confira também