RemovePropA 함수(winuser.h)
지정된 창의 속성 목록에서 항목을 제거합니다. 지정된 문자 문자열은 제거할 항목을 식별합니다.
통사론
HANDLE RemovePropA(
[in] HWND hWnd,
[in] LPCSTR lpString
);
매개 변수
[in] hWnd
형식: HWND
속성 목록을 변경할 창에 대한 핸들입니다.
[in] lpString
형식: LPCTSTR
null로 끝나는 문자열 또는 문자열을 식별하는 원자입니다. 이 매개 변수가 원자인 경우 GlobalAddAtom 함수를 사용하여 만들어야 합니다. 16비트 값인 원자는 lpString;의 하위 단어에 배치되어야 합니다. 상위 단어는 0이어야 합니다.
반환 값
형식: HANDLE
반환 값은 지정된 데이터를 식별합니다. 지정된 속성 목록에서 데이터를 찾을 수 없는 경우 반환 값은 NULL
발언
반환 값은 SetProp;에 전달된 hData 값입니다. 애플리케이션 정의 값입니다. 이 함수는 데이터와 창 간의 연결만 삭제합니다. 적절한 경우 애플리케이션은 속성 목록에서 제거된 항목과 연결된 데이터 핸들을 해제해야 합니다. 애플리케이션은 추가한 속성만 제거할 수 있습니다. 다른 애플리케이션 또는 시스템 자체에 의해 추가된 속성을 제거해서는 안 됩니다.
RemoveProp 함수는 애플리케이션이 핸들과 연결된 데이터를 해제할 수 있도록 문자열과 연결된 데이터 핸들을 반환합니다.
Windows Vista부터 RemoveProp UIPI(사용자 인터페이스 권한 격리)의 제한 사항이 적용됩니다. 프로세스는 무결성 수준이 작거나 같은 프로세스에 속하는 창에서만 이 함수를 호출할 수 있습니다. UIPI가 속성 변경을 차단하면 GetLastError
예제
예를 들어 창 속성삭제하는
메모
winuser.h 헤더는 REMOVEProp을 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 집합 | ext-ms-win-ntuser-window-l1-1-0(Windows 8에서 도입) |
참고 항목
AddAtom
개념
GetProp
참조
SetProp