SetUserObjectInformationA 함수(winuser.h)

지정된 창 스테이션 또는 데스크톱 개체에 대한 정보를 설정합니다.

통사론

BOOL SetUserObjectInformationA(
  [in] HANDLE hObj,
  [in] int    nIndex,
  [in] PVOID  pvInfo,
  [in] DWORD  nLength
);

매개 변수

[in] hObj

창 스테이션, 데스크톱 개체 또는 현재 프로세스 의사 핸들에 대한 핸들입니다. 이 핸들은 CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop 또는 GetCurrentProcess 함수에서 반환할 수 있습니다.

[in] nIndex

설정할 개체 정보입니다. 이 매개 변수는 다음 값일 수 있습니다.

값	의미
UOI_FLAGS 1	개체의 핸들 플래그를 설정합니다. pvInfo 매개 변수는 USEROBJECTFLAGS 구조를 가리킵니다.
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	TimerProc호출할 때 예외 처리 동작을 설정합니다. hObjGetCurrentProcess 함수에서 반환하는 프로세스 핸들이어야 합니다. pvInfo 매개 변수는 BOOL을 가리킵니다. TRUE이면 Windows는 모든 예외를 사용하고 삭제하는 예외 처리기로 TimerProc 호출을 묶습니다. 이는 Windows 2000 이후의 기본 동작이지만 이후 버전의 Windows에서는 변경될 수 있습니다. pvInfo FALSE를 가리키는 경우 Windows는 TimerProc 호출을 예외 처리기로 묶지 않습니다. FALSE 설정을 사용하는 것이 좋습니다. 그렇지 않으면 애플리케이션이 예측 불가능하게 동작할 수 있으며 보안 악용에 더 취약할 수 있습니다.

[in] pvInfo

개체 정보를 포함하는 버퍼 또는 BOOL에 대한 포인터입니다.

[in] nLength

pvInfo가리키는 버퍼에 포함된 정보의 크기(바이트)입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

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

발언

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll

참고 항목

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

창 스테이션 및 데스크톱 함수

창 스테이션