PROPERTYINFO 구조체
PROPERTYINFO 데이터 구조는 프로토콜의 하나의 속성을 정의합니다.
typedef struct _PROPERTYINFO {
HPROPERTY hProperty;
DWORD Version;
LPSTR Label;
LPSTR Comment;
BYTE DataType;
BYTE DataQualifier;
union {
LPVOID lpExtendedInfo;
LPRANGE lpRange;
LPSET lpSet;
DWORD Bitmask;
DWORD Value;
};
WORD FormatStringSize;
LPVOID InstanceData;
} PROPERTYINFO, *LPPROPERTYINFO;
-
hProperty
-
이 필드를 0으로 설정합니다. 출력에서 네트워크 모니터는 속성 데이터베이스에 속성을 추가한 후 속성에 대한 핸들을 반환합니다.
-
버전
-
예약되어 있습니다. 0으로 설정해야 합니다.
-
레이블
-
속성의 이름입니다.
-
설명
-
속성에 대한 설명입니다. 설명은 네트워크 모니터 상태 표시줄에 표시됩니다.
-
DataType
-
속성의 데이터 형식입니다. 이 멤버는 다음 값 중 하나를 가질 수 있습니다.
값 의미 - PROP_TYPE_VOID
속성 형식을 알 수 없습니다. 묵시적 길이 또는 형식이 없습니다. - PROP_TYPE_SUMMARY
속성 형식 요약 파서가 프레임에 연결하는 첫 번째 속성 instance 나타냅니다. PROP_TYPE_SUMMARY 속성 그룹의 자리 표시자 역할을 할 수 있습니다. 이 값은 속성이 프로토콜 RFC에 정의되어 있지 않음을 나타냅니다. - PROP_TYPE_BYTE
크기가 1 바이트(8비트 엔터티)인 숫자 데이터입니다. - PROP_TYPE_WORD
크기가 2바이트(16비트 엔터티)인 숫자 데이터입니다. - PROP_TYPE_DWORD
크기가 4바이트(32비트 엔터티)인 숫자 데이터입니다. - PROP_TYPE_LARGEINT
크기가 8바이트(64비트 엔터티)인 숫자 데이터입니다. - PROP_TYPE_ADDR
MAC 주소(6 바이트 엔터티). - PROP_TYPE_TIME
SYSTEMTIME 구조체. - PROP_TYPE_STRING
ASCII 텍스트 데이터입니다. 이 데이터 형식은 NULL로 종료되지 않습니다.
유니코드 데이터의 경우 ASCII 텍스트 데이터를 지정할 때 attach 속성 instance 함수가 호출될 때도 IFLAG_UNICODE 플래그를 설정해야 합니다.- PROP_TYPE_IP_ADDRESS
IP 주소. (4 바이트 엔터티). - PROP_TYPE_IPX_ADDRESS
IPX 주소. (10 바이트 엔터티). - PROP_TYPE_BYTESWAPPED_WORD
사용되지 않습니다. 바이트 교환 WORD 데이터의 경우 DataType을 PROP_TYPE_WORD 설정하고 Attach 속성 instance 함수를 호출할 때 IFLAG_SWAPPED 플래그를 설정합니다. - PROP_TYPE_BYTESWAPPED_DWORD
사용되지 않습니다. 바이트 교환 DWORD 데이터의 경우 DataType을 PROP_TYPE_DWORD 설정하고 Attach 속성 instance 함수를 호출할 때 IFLAG_SWAPPED 플래그를 설정합니다. - PROP_TYPE_TYPED_STRING
사용되지 않습니다. 변수 형식 문자열 데이터의 경우 DataType을 PROP_TYPE_STRING 설정하고 Attach 속성 instance 함수를 호출할 때 IFLAG_UNICODE 플래그를 설정합니다. - PROP_TYPE_RAW_DATA
알 수 없는 길이 및 형식의 원시 데이터입니다. - PROP_TYPE_COMMENT
PROP_TYPE_VOID 동일합니다. - PROP_TYPE_SRCFRIENDLYNAME
원본에 친숙한 이름의 주소입니다. 네트워크 모니터는 이 데이터 형식에 대한 기본 제공 서식 지원을 제공하지 않습니다. - PROP_TYPE_DSTFRIENDLYNAME
대상 식별 이름의 주소입니다. 네트워크 모니터는 이 데이터 형식에 대한 기본 제공 서식 지원을 제공하지 않습니다. - PROP_TYPE_TOKENRING_ADDRESS
토큰 링 주소입니다. 네트워크 모니터는 이 데이터 형식에 대한 기본 제공 서식 지원을 제공하지 않습니다. - PROP_TYPE_FDDI_ADDRESS
FDDI 주소입니다. 네트워크 모니터는 이 데이터 형식에 대한 기본 제공 서식 지원을 제공하지 않습니다. - PROP_TYPE_ETHERNET_ADDRESS
이더넷 주소입니다. 네트워크 모니터는 이 데이터 형식에 대한 기본 제공 서식 지원을 제공하지 않습니다. - PROP_TYPE_OBJECT_IDENTIFIER
BER로 인코딩된 SNMP 개체 식별자입니다. - PROP_TYPE_VINES_IP_ADDRESS
덩굴 IP 주소(6바이트 엔터티). - PROP_TYPE_VAR_LEN_SMALL_INT
미리 결정된 길이가 없지만 길이가 8바이트 이하인 숫자 값입니다. 연결된 데이터의 길이는 값의 길이를 결정합니다. -
DataQualifier
-
속성의 데이터 한정자입니다. 이 멤버는 데이터 형식에 대한 정확한 정보를 제공합니다.
DataQualifier 에는 다음 값 중 하나가 있을 수 있습니다.
값 의미 - PROP_QUAL_NONE
속성 데이터 형식은 속성의 유일한 사양입니다.
이 값을 설정하면 구조체의 공용 구조체 멤버가 NULL로 설정된 다음 무시됩니다.- PROP_QUAL_RANGE
숫자 값은 지정된 범위 내에 있어야 합니다. lpRange 멤버에서 범위를 정의합니다. - PROP_QUAL_SET
속성 값은 구조체의 공용 구조체의 lpSet 멤버에 지정된 값 집합과 비교됩니다. 속성 값은 BYTE, WORD, DWORD, LARGEINT 또는 TIME일 수 있습니다. - PROP_QUAL_BITFIELD
사용되지 않습니다. - PROP_QUAL_LABELED_SET
속성 값은 값 레이블 쌍 집합의 값과 비교됩니다. 값 레이블 쌍은 구조체의 공용 구조체의 lpSet 멤버에 지정됩니다.
표시 시 속성 값이 집합의 값과 일치하면 값과 연결된 레이블이 모두 표시됩니다.- PROP_QUAL_LABELED_BITFIELD
사용되지 않습니다. 대신 PROP_QUAL_FLAGS 사용합니다. - PROP_QUAL_CONST
속성 값은 공용 구조체의 Value 멤버에 지정된 상수와 비교됩니다.
표시 시 속성 값과 상수가 일치하지 않으면 형식이 지정된 오류 메시지가 표시되고 값이 Normal으로 설정됩니다.- PROP_QUAL_FLAGS
속성 값은 공용 구조체의 lpSet 멤버에서 식별된 특정 BIT와 비교됩니다. - PROP_QUAL_ARRAY
속성의 값은 값 배열을 지정합니다. 연결된 데이터의 길이에 따라 배열 길이가 결정됩니다.
PROP_QUAL_ARRAY 값이 설정되면 PROPERTYINFO 데이터 구조의 공용 구조체 멤버가 NULL 로 설정되고 무시됩니다. -
lpExtendedInfo
-
예약됨(공용 구조체의 구성원).
-
lpRange
-
값 범위를 정의하는 RANGE 구조체에 대한 포인터입니다. 이 구조체의 DataQualifier 멤버가 PROP_QUAL_RANGE(공용 구조체의 멤버)로 설정된 경우 이 멤버를 설정해야 합니다.
-
lpSet
-
값 또는 레이블 집합을 지정하는 SET 구조체에 대한 포인터입니다. 구조체의 DataQualifier 멤버가 PROP_QUAL_SET, PROP_QUAL_LABELED_SET 또는 PROP_QUAL_FLAGS(공용 구조체의 구성원)로 설정된 경우 이 멤버를 설정해야 합니다.
-
비트 마스크
-
사용되지 않음(공용 구조체의 구성원).
-
값
-
DataQualifier를 PROP_QUAL_CONST(공용 구조체의 구성원)로 설정할 때 사용되는 상수 값입니다.
-
FormatStringSize
-
속성 설명에만 사용되는 최대 크기입니다.
-
InstanceData
-
속성에 대해 표시된 데이터의 서식을 지정하기 위해 호출되는 format 함수를 지정합니다. 제네릭 포맷터를 사용하려면 FormatPropertyInstance 함수를 지정합니다.
PROPERTYINFO 구조체는 AddProperty 함수 호출에 사용됩니다. AddProperty 함수는 파서 속성 데이터베이스에 단일 속성 정의를 추가합니다.
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
헤더 |
|