ElementSize
Actualización: noviembre 2007
La propiedad ElementSize se utiliza para especificar un tamaño de elemento, en bytes, que depende del valor de otro parámetro de la función. Esta propiedad está permitida en atributos Pre y Post, sólo puede aplicarse a tipos de datos de puntero o de matriz.
La propiedad ElementSize se debe usar junto con cualquiera de las propiedades siguientes:
ValidElements
ValidElementsLength
ValidElementsConst
WritableElements
WritableElementsConst
WritableElementsLength
El valor de la propiedad ElementSize es un parámetro de la función de tipo size_t. Para especificar un tamaño de elemento constante, utilice la propiedad ElementSizeConst.
Nota: |
---|
Si se pasa size_tcount* como parámetro size, se utilizará ElementSize="*count" para especificar el valor de la propiedad. |
Ejemplo
En el código siguiente se muestra el uso de otro parámetro (size_t count) para especificar el tamaño de cada elemento de pc utilizando la propiedad ElementSize:
// C
#include <CodeAnalysis\SourceAnnotations.h>
void f ([SA_Pre(Deref=0, Null=SA_No, ElementSize="count", WritableElementsConst=3)] void *pc, size_t count);
// C++
#include <CodeAnalysis\SourceAnnotations.h>
using namespace vc_attributes;
void f ([Pre(Deref=0, Null=No, ElementSize="count", WritableElementsConst=3)] void *pc, size_t count);