ElementSize
Aktualisiert: November 2007
Mit der ElementSize-Eigenschaft wird eine Elementgröße in Bytes angegeben, die vom Wert eines anderen Parameters der Funktion abhängt. Diese Eigenschaft ist beim Pre-Attribut und beim Post-Attribut zulässig und kann nur auf Zeiger- oder Arraydatentypen angewendet werden.
Die ElementSize-Eigenschaft muss in Verbindung mit einer der folgenden Eigenschaften verwendet werden:
ValidElements
ValidElementsLength
ValidElementsConst
WritableElements
WritableElementsConst
WritableElementsLength
Der Wert der ElementSize-Eigenschaft ist ein Parameter der Funktion des Typs size_t. Verwenden Sie zum Angeben einer Elementgröße, die eine Konstante ist, die ElementSizeConst-Eigenschaft.
.gif "Hinweis") Hinweis: |
|---|
Wenn als Größenparameter size_t*count übergeben wird, wird der Eigenschaftenwert mit ElementSize="*count" angegeben. |
Beispiel
Der folgende Code zeigt, wie ein anderer Parameter (size_t count) verwendet wird, um die Größe der einzelnen Elemente in pc mithilfe der ElementSize-Eigenschaft anzugeben:
// 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);