Ler em inglês

Compartilhar via


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

AcF (Arquivo de Configuração de Aplicativo)

/app_config

Código

explicit_handle

context_handle

implicit_handle

nocode