ValidBytes
Aktualisiert: November 2007
Mit der ValidBytes-Eigenschaft wird die Anzahl der Bytes in einem Array oder einem Puffer angegeben, auf den mit einem Zeiger verwiesen wird, der gelesen werden darf. Diese Eigenschaft ist beim Pre-Attribut und beim Post-Attribut zulässig und kann nur auf Zeiger- oder Arraydatentypen angewendet werden.
Der Wert dieser Eigenschaft ist ein Ausdruck, der einen weiteren Parameter des ganzzahligen Typs mit einem Bereich kleiner oder gleich size_t enthält, durch den die tatsächliche Anzahl lesbarer Bytes bestimmt wird.
Beispiel
Die folgenden zwei Codebeispiele zeigen, wie die ValidBytes-Eigenschaft verwendet wird:
// C
#include <CodeAnalysis\SourceAnnotations.h>
void f([SA_Pre(ValidBytes="c") ] char *pc, size_t c);
-or-
void f([SA_Pre(ValidBytes="*c") ] char *pc, size_t *c);
// use dereference operator, size is passed as a pointer
// C++
#include <CodeAnalysis\SourceAnnotations.h>
using namespace vc_attributes;
void f([Pre(ValidBytes="c") ] char *pc, size_t c);
-or-
void f([Pre(ValidBytes="*c") ] char *pc, size_t *c);
// use dereference operator, size is passed as a pointer
Die ValidBytes-Eigenschaft kann nicht auf einen Funktionszeiger angewendet werden.