PROPENUMPROCEXA 콜백 함수(winuser.h)

아티클
03/15/2023

EnumPropsEx 함수와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 함수는 창의 속성 목록에서 속성 항목을 받습니다. PROPENUMPROCEX 형식은 이 콜백 함수에 대한 포인터를 정의합니다. PropEnumProcEx 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

매개 변수

unnamedParam1

형식: HWND

속성 목록이 열거되는 창에 대한 핸들입니다.

unnamedParam2

형식: LPTSTR

속성 목록 항목의 문자열 구성 요소입니다. SetProp 함수에 대한 호출을 통해 속성이 창의 속성 목록에 추가되었을 때 데이터 핸들과 함께 지정된 문자열입니다.

unnamedParam3

형식: HANDLE

데이터에 대한 핸들입니다. 이 핸들은 속성 목록 항목의 데이터 구성 요소입니다.

unnamedParam4

형식: ULONG_PTR

애플리케이션 정의 데이터입니다. 열거형을 시작한 EnumPropsEx 호출의 lParam 매개 변수로 지정된 값입니다.

반환 값

형식: BOOL

TRUE를 반환하여 속성 목록 열거형을 계속합니다.

FALSE를 반환하여 속성 목록 열거를 중지합니다.

설명

이 콜백 함수에는 다음과 같은 제한 사항이 적용됩니다.

콜백 함수는 RemoveProp 함수를 호출할 수 있습니다. 그러나 RemoveProp 은 콜백 함수의 매개 변수를 통해 콜백 함수에 전달된 속성만 제거할 수 있습니다.
콜백 함수는 속성을 추가하려고 시도해서는 안 됩니다.

참고

winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 PROPENUMPROCEX를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)