Extensiones rpc de Microsoft Binding-Handle

  • Artículo

Las extensiones de Microsoft para el lenguaje IDL admiten varios parámetros de identificador que aparecen en posiciones distintas del primer parámetro, situado más a la izquierda. En los pasos siguientes se describe la secuencia a la que pasa el compilador MIDL para resolver el parámetro binding-handle en el modo de compatibilidad DCE (/osf) y en modo predeterminado (extendido por Microsoft).

Modo de compatibilidad con DCE

  • Identificador de enlace que aparece en la primera posición.
  • Parámetro [in, context_handle] situado más a la izquierda.
  • Identificador de enlace implícito especificado por [implicit_handle] o [auto_handle].
  • Si no hay ningún ACF presente, el valor predeterminado es el uso de [auto_handle].

Modo predeterminado

  • Identificador de enlace explícito más a la izquierda.
  • Identificador de enlace implícito especificado por [implicit_handle] o [auto_handle].
  • Si no hay ningún ACF presente, el valor predeterminado es el uso de [auto_handle].

Los compiladores IDL de DCE buscan un identificador de enlace explícito como primer parámetro. Cuando el primer parámetro no es un identificador de enlace y se especifican uno o varios identificadores de contexto, el identificador de contexto más a la izquierda se usa como identificador de enlace. Cuando el primer parámetro no es un identificador y no hay identificadores de contexto, el procedimiento usa el enlace implícito mediante el atributo ACF [implicit_handle] o [auto_handle].

Las extensiones de Microsoft al IDL permiten que el identificador de enlace esté en una posición distinta del primer parámetro. El parámetro [in] explicit-handle más a la izquierda, ya sea un identificador primitivo, definido por el programador o un controlador de contexto, es el identificador de enlace. Cuando no hay parámetros de identificador, el procedimiento usa el enlace implícito mediante el atributo ACF [implicit_handle] o [auto_handle].

Las reglas siguientes se aplican tanto al modo de compatibilidad con DCE (/osf) como al modo predeterminado:

  • El enlace de control automático se usa cuando no hay ningún ACF presente.
  • Identificadores explícitos [in] o [in, out] para una función individual preempt cualquier enlace implícito especificado para la interfaz.
  • No se admiten varios identificadores primitivos [in] o [in, out].
  • Se permiten varios identificadores de contexto explícitos [in] o [in, out].
  • Todos los parámetros de identificador definidos por el programador, excepto el parámetro binding-handle, se tratan como datos transmisibles.

La tabla siguiente contiene ejemplos y describe cómo se asignan los identificadores de enlace en cada modo de compilador.

Ejemplo Descripción 
void proc1( void );
 No se especifica ningún identificador explícito. Se usa el identificador de enlace implícito, especificado por [ implicit_handle] o [ auto_handle]. Cuando no hay ningún controlador ACF, se usa un identificador automático. 
void proc2([in] handle_t H,           [in] short s );
 Se especifica un identificador explícito de tipo handle_t. El parámetro H es el identificador de enlace del procedimiento. 
void proc3([in] short s,           [in] handle_t H );
 El primer parámetro no es un identificador. En el modo predeterminado, el parámetro de identificador más a la izquierda, H, es el identificador de enlace. En el modo /osf, se usa el enlace implícito. Se notifica un error porque se espera que el segundo parámetro sea transmisible y handle_t no se pueda transmitir. 
typedef [handle] short * MY_HDL;void proc1([in] short s,           [in] MY_HDL H );
 El primer parámetro no es un identificador. En el modo predeterminado, el parámetro de identificador más a la izquierda, H, es el identificador de enlace. Los códigos auxiliares llaman a las rutinas proporcionadas por el usuario MY_HDL_bind y MY_HDL_unbind. En modo in/osf, se usa el enlace implícito. El parámetro de identificador definido por el programador H se trata como datos transmisibles. 
Typedef [handle] short * MY_HDL;void proc1([in] MY_HDL H,            [in] MY_HDL p );
 El primer parámetro es un identificador de enlace. El parámetro H es el parámetro binding-handle. El segundo parámetro de identificador definido por el programador se trata como datos transmisibles. 
Typedef [context_handle] void * CTXT_HDL;void proc1([in] short s,           [in] long l,           [in] CTXT_HDL H ,           [in] char c);
 El identificador de enlace es un identificador de contexto. El parámetro H es el identificador de enlace.