SetPropA 함수(winuser.h)

아티클
03/04/2024

새 항목을 추가하거나 지정된 창의 속성 목록에서 기존 항목을 변경합니다. 지정된 문자열이 목록에 아직 없는 경우 함수는 목록에 새 항목을 추가합니다. 새 항목에는 문자열과 핸들이 포함됩니다. 그렇지 않으면 함수는 문자열의 현재 핸들을 지정된 핸들로 바꿉니다.

구문

BOOL SetPropA(
  [in]           HWND   hWnd,
  [in]           LPCSTR lpString,
  [in, optional] HANDLE hData
);

매개 변수

[in] hWnd

형식: HWND

속성 목록이 새 항목을 수신하는 창에 대한 핸들입니다.

[in] lpString

형식: LPCTSTR

null로 끝나는 문자열 또는 문자열을 식별하는 원자입니다. 이 매개 변수가 원자인 경우 GlobalAddAtom 함수에 대한 이전 호출에서 만든 전역 원자여야 합니다. 원자는 lpString의 하위 단어에 배치해야 합니다. 상위 단어는 0이어야 합니다.

[in, optional] hData

형식: HANDLE

속성 목록에 복사할 데이터에 대한 핸들입니다. 데이터 핸들은 애플리케이션에 유용한 값을 식별할 수 있습니다.

반환 값

형식: BOOL

데이터 핸들과 문자열이 속성 목록에 추가되면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

창이 제거되기 전에(즉, WM_NCDESTROY 메시지 처리에서 반환되기 전에) 애플리케이션은 속성 목록에 추가한 모든 항목을 제거해야 합니다. 애플리케이션은 RemoveProp 함수를 사용하여 항목을 제거해야 합니다.

SetProp 에는 UIPI(사용자 인터페이스 권한 격리)의 제한 사항이 적용됩니다. 프로세스는 무결성 수준이 낮거나 같은 프로세스에 속하는 창에서만 이 함수를 호출할 수 있습니다. UIPI가 속성 변경을 차단하면 GetLastError 는 5를 반환합니다.

예제

예제는 창 속성 추가를 참조하세요.

참고

winuser.h 헤더는 SETProp을 별칭으로 정의하여 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-4(Windows 10 버전 10.0.14393에 도입됨)