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