AttachPropertyInstance 함수

AttachPropertyInstance 함수는 인식된 데이터의 특정 위치에 기존 속성을 매핑합니다.

구문

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

매개 변수

hFrame [in]

구문 분석 중인 프레임에 대한 핸들입니다. AttachProperties 함수의 hFrame 매개 변수에서 파서 DLL에 전달된 핸들을 사용합니다.

hProperty [in]

속성을 정의하는 PROPERTYINFO 구조체에 대한 핸들입니다. 내보내기 등록 함수를 구현할 때 속성을 정의하는 PROPERTYINFO 구조를 지정합니다.

길이 [in]

속성의 이 instance 대한 데이터 길이입니다.

lpData [in]

속성 값이 있는 인식된 데이터의 위치에 대한 포인터입니다. AttachProperties 함수의 lpProtocol 매개 변수에서 파서 DLL에 전달된 포인터를 사용합니다.

HelpID [in]

속성에 대한 컨텍스트 구분 도움말을 설정하는 데 사용되는 식별자(0~2047)입니다.

식별자 번호는 프로토콜 속성 데이터베이스와 연결된 도움말 파일을 기준으로 합니다.

IndentLevel [in]

속성을 계층적으로 표시하는 데 사용되는 들여쓰기 수준(0에서 15까지)입니다.

네트워크 모니터는 수준 0~14를 사용하여 속성을 들여쓰기합니다. 수준 15는 파서가 표시되지 않는 숨겨진 속성을 연결할 수 있는 특수 값입니다.

IFlags [in]

속성 내의 BIT 순서를 나타내는 BIT 필드 값입니다. fError를 0 또는 1로 설정한 이전 파서는 이제 fError를 IFLAG_ERROR 설정해야 합니다. 이 매개 변수를 다음 값 중 하나로 설정합니다.

값	의미
IFLAG_ERROR	프레임의 데이터에 오류가 있습니다.
IFLAG_SWAPPED	연결 시 WORD 바이트는 Intel이 아닌 형식입니다.
IFLAG_UNICODE	연결 시 STRING 은 유니코드입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다.

설명

AttachPropertyInstance 함수는 AttachProperties 내보내기 함수를 구현하는 동안 호출됩니다. 속성이 데이터에 연결되면 네트워크 모니터는 연결된 속성의 instance 정의하는 PROPERTYINST 구조를 만듭니다.

AttachProperties를 구현하는 동안 AttachPropertyInstance를 호출하여 캡처에 있는 데이터를 사용합니다. AttachPropertyInstanceEx 함수를 호출하여 속성 데이터를 수정할 수도 있습니다. 그러나 캡처에 있는 데이터를 사용하는 것이 좋습니다.

요구 사항

추가 정보

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST