Compartilhar via


atributo implicit_handle

O atributo ACF [implicit_handle] especifica o identificador usado para funções que não incluem um identificador explícito como um parâmetro de procedimento.

implicit_handle(handle-type handle-name)

Parâmetros

tipo de identificador

Especifica o tipo de dados de identificador, como o tipo base handle_t ou um tipo de identificador definido pelo usuário.

handle-name

Especifica o nome do identificador.

Comentários

O identificador especificado pelo atributo [implicit_handle] é usado de maneiras diferentes, dependendo da natureza do procedimento. Se o procedimento for remoto, o identificador será usado como o identificador de associação para a chamada remota. O identificador implícito também pode ser usado para estabelecer uma associação inicial para uma função que usa um identificador de contexto. Se o procedimento for um procedimento de serialização, o identificador será usado como um identificador de serialização que controla a operação. No caso de serialização de tipo, o identificador é usado como o identificador de serialização para todos os tipos serializados.

O atributo [implicit_handle] especifica uma variável global que contém um identificador usado por qualquer função que precise de identificadores implícitos.

O tipo de identificador de associação implícita deve ser handle_t (ou um tipo baseado em handle_t) ou um tipo de identificador definido pelo usuário especificado com o atributo handle . O identificador de serialização implícita deve ser um tipo baseado em handle_t.

Se o tipo de identificador implícito não estiver definido no arquivo IDL ou em arquivos incluídos e importados pelo arquivo IDL para o computador MIDL, você deverá fornecer o arquivo que contém a definição de tipo de identificador ao compilar os stubs. Use a instrução ACF include para incluir o arquivo que contém a definição de tipo de identificador.

O atributo [implicit_handle] pode ocorrer uma vez, no máximo. O atributo [implicit_handle] só poderá ocorrer se os atributos [auto_handle] e [explicit_handle] não ocorrerem.

Exemplos

/* ACF file */ 
[
    implicit_handle(handle_t hMyHandle)
] 
interface iface
{ 
    // Attribute configuration statements
}

Confira também

Arquivo de Configuração de Aplicativo (ACF)

auto_handle

explicit_handle

handle_t

include