AttachPropertyInstanceEx 함수

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

구문

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _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에 전달된 포인터를 사용합니다.

LengthEx [in]

확장된 데이터 길이(바이트)의 길이입니다.

lpDataEx [in]

확장 데이터를 포함하는 스택 변수인 확장 데이터에 대한 포인터입니다.

HelpID [in]

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

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

IndentLevel [in]

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

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

IFlags [in]

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

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

반환 값

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

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

설명

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

AttachPropertyInstanceEx가 호출되고 확장된 데이터가 제공되지 않으면 lpDataEx 매개 변수가 NULL이거나 LengthEx 매개 변수가 0이면 AttachPropertyInstanceEx 호출이 AttachPropertyInstance 호출과 기능적으로 동일합니다.

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

요구 사항