Cómo encontrar información de objetos en la documentación de dispositivos

Presentación

En la documentación de dispositivos encontrará descripciones de objetos correspondientes a los datos a los que desea acceder. Generalmente reciben el nombre de objetos de aplicación, y se puede acceder a ellos a través de mensajes explícitos o bien su descripción indica que pertenecen a la categoría 3.

Un objeto es parecido a un diccionario en la programación de software. Existen diversos tipos de diccionarios, como por ejemplo los que se ordenan automáticamente o los que incluyen diferentes mecanismos de búsqueda. Por ejemplo, SortedDictionary es una clase, y UnsortedDictionary es otra clase. Si se genera un objeto mediante una de estas clases, los identificadores de las clases serán, respectivamente, SortedDictionary y UnsortedDictionary.

La instanciación de un objeto de este tipo con un nombre de variable myDictionary significa que se ha asignado un área reservada de la memoria a este diccionario con el nombre instance, por ejemplo. Su identificador es myDictionary.

Dentro de un diccionario, los valores se almacenan en una estructura (clave, valor). El diccionario proporciona un método para obtener la lista de claves con el nombre attribute, por ejemplo. Su identificador es GetKeys. Este diccionario cuenta también con un método para obtener la lista de valores. Este método es otro attribute, cuyo identificador es Values. Dado que ambos identificadores de atributo son comunes en ambas clases, reciben el nombre de "atributos" de la "clase". En efecto, existe un atributo exclusivo para SortedDictionary con el identificador GetSortedKeys. En este caso, recibe el nombre de "atributo de instancia".

Los atributos también pueden admitir diversos servicios. En el caso del atributo GetKeys, este admite el servicio Get_Attribute_Single (acceso de lectura), mientras que el atributo Values admite los servicios Get_Attribute_Single o Set_Attribute_Single (acceso de lectura y escritura); los identificadores correspondientes de los servicios admitidos son Get_Attribute_Single o Set_Attribute_Single.

Según el bloque de funciones que se utilice, la información correspondiente será como sigue:

  • i_byService: el identificador del servicio que se utilizará para acceder a los datos; puede encontrarse buscando por ejemplo "servicios de atributos de clase admitidos" o "servicios de atributos de instancia admitidos".

  • i_dwClass: el identificador de la clase que describe el objeto al que se desea acceder; "ID de clase" es una propiedad numérica, expresada habitualmente como valor hexadecimal.

  • i_dwInstance: el identificador de la instancia que describe el objeto al que se desea acceder; "ID de instancia" es una propiedad numérica, expresada habitualmente como valor hexadecimal.

  • i_dwAttribute: el identificador del atributo al que se desea acceder, el tipo de datos deseados; puede tratarse de un atributo de clase común para todas las instancias de una misma clase o simplemente de un atributo de instancia; "ID de atributo" es una propiedad numérica, expresada habitualmente como valor hexadecimal.

  • i_dwMember: identifica el objeto como miembro de un grupo, aunque rara vez se utiliza.