ValidBytes
Mit der ValidBytes-Eigenschaft wird die Anzahl der Bytes in einem Array oder einem Puffer, auf den mit einem Zeiger verwiesen wird, angegeben, 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 gibt einen Größenparameter des ganzzahligen Typs mit einem Bereich kleiner oder gleich size_t an, 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([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
// 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.