FormatPropertyInstance 함수
FormatPropertyInstance 함수는 네트워크 모니터에서 제공하는 제네릭 포맷터를 사용하여 속성 instance 데이터의 형식을 지정합니다.
구문
DWORD WINAPIV FormatPropertyInstance(
_Inout_ LPPROPERTYINST lpPropertyInst
);
매개 변수
-
lpPropertyInst [in, out]
-
instance 데이터를 포함하는 PROPERTYINST 구조체에 대한 포인터입니다.
입력 시 제네릭 포맷터는 PROPERTYINST 공용 구조체 멤버 중 하나에서 instance 데이터를 가져와 해당 데이터를 미리 정의된 형식의 문자열로 변환합니다.
출력에서 제네릭 포맷터는 PROPERTYINST 구조체의 szPropertyText 멤버를 형식이 지정된 문자열에 대한 포인터로 설정합니다.
반환 값
함수가 성공하면 반환 값이 NMERR_SUCCESS.
함수가 실패하면 반환 값은 NMerr.h의 오류 코드입니다.
설명
파서 DLL은 제네릭 포맷터가 네트워크 모니터 UI의 세부 정보 창에 표시할 데이터의 서식을 지정해야 하는 경우 FormatPropertyInstance 함수를 간접적으로 호출합니다. FormatPropertyInstance를 호출하려면 속성을 정의할 때 PROPERTYINFO 구조체의 InstanceData 멤버에 지정합니다.
참고
파서는 속성의 instance 형식을 지정해야 하는 경우 호출되는 함수를 인식하지 못합니다. 함수는 FormatPropertyInstance 또는 파서에서 정의한 사용자 지정 형식 함수일 수 있습니다. 파서는 속성에 대한 PROPERTYINFO 구조체의 InstanceData 멤버에 의해 지정된 형식 함수를 호출합니다.
formatproperties를 구현하는 방법에 대한 자세한 내용과 예제는 FormatProperties 구현을 참조하세요. 제네릭 포맷터가 다양한 형식의 데이터에 서식을 지정하는 방법에 대한 자세한 내용은 제네릭 포맷터 출력을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|