GetUserObjectInformationA 함수(winuser.h)

아티클
08/27/2023

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

구문

BOOL GetUserObjectInformationA(
  [in]            HANDLE  hObj,
  [in]            int     nIndex,
  [out, optional] PVOID   pvInfo,
  [in]            DWORD   nLength,
  [out, optional] LPDWORD lpnLengthNeeded
);

매개 변수

[in] hObj

창 스테이션 또는 데스크톱 개체에 대한 핸들입니다. 이 핸들은 CreateWindowStation, OpenWindowStation, CreateDesktop 또는 OpenDesktop 함수에서 반환 됩니다 .

[in] nIndex

검색할 정보입니다. 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
UOI_FLAGS 1	핸들 플래그입니다. pvInfo 매개 변수는 USEROBJECTFLAGS 구조를 가리킵니다.
UOI_HEAPSIZE 5	ULONG 값으로 데스크톱 힙의 크기(KB)입니다. hObj 매개 변수는 데스크톱 개체에 대한 핸들이어야 합니다. 그렇지 않으면 함수가 실패합니다. Windows Server 2003 및 Windows XP/2000: 이 값은 지원되지 않습니다.
UOI_IO 6	true 이면 hObj 매개 변수가 사용자로부터 입력을 수신하는 데스크톱 개체에 대한 핸들입니다. 그렇지 않으면 FALSE 입니다. Windows Server 2003 및 Windows XP/2000: 이 값은 지원되지 않습니다.
UOI_NAME 2	문자열인 개체의 이름입니다.
UOI_TYPE 3	개체의 형식 이름(문자열)입니다.
UOI_USER_SID 4	현재 지정된 개체와 연결된 사용자를 식별하는 SID 구조체입니다. 개체와 연결된 사용자가 없는 경우 lpnLengthNeeded 가 가리키는 버퍼에 반환된 값은 0입니다. SID는 가변 길이 구조입니다. 일반적으로 값을 검색하기 전에 GetUserObjectInformation 을 호출하여 SID 의 길이를 확인합니다.

[out, optional] pvInfo

개체 정보를 받을 버퍼에 대한 포인터입니다.

[in] nLength

pvInfo 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

[out, optional] lpnLengthNeeded

요청된 정보를 저장하는 데 필요한 바이트 수를 받는 변수에 대한 포인터입니다. 함수가 반환할 때 이 변수의 값이 nLength 매개 변수 값보다 크면 함수는 FALSE를 반환하고 pvInfo 버퍼에 정보가 복사되지 않습니다. lpnLengthNeeded가 가리키는 변수 값이 nLength 값보다 작거나 같으면 전체 정보 블록이 복사됩니다.

반환 값

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

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

설명

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-windowstation-ansi-l1-1-0(Windows 10 버전 10.0.10240에 도입됨)