GetUserObjectInformationA 함수(winuser.h)
지정된 창 스테이션 또는 데스크톱 개체에 대한 정보를 검색합니다.
통사론
BOOL GetUserObjectInformationA(
[in] HANDLE hObj,
[in] int nIndex,
[out, optional] PVOID pvInfo,
[in] DWORD nLength,
[out, optional] LPDWORD lpnLengthNeeded
);
매개 변수
[in] hObj
창 스테이션 또는 데스크톱 개체에 대한 핸들입니다. 이 핸들은
[in] nIndex
검색할 정보입니다. 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
핸들 플래그입니다. pvInfo 매개 변수는 USEROBJECTFLAGS 구조를 가리킵니다. |
|
ULONG 값인 데스크톱 힙의 크기(KB)입니다.
hObj 매개 변수는 데스크톱 개체에 대한 핸들이어야 합니다. 그렇지 않으면 함수가 실패합니다.
Windows Server 2003 및 Windows XP/2000: 이 값은 지원되지 않습니다. |
|
Windows Server 2003 및 Windows XP/2000: 이 값은 지원되지 않습니다. |
|
문자열인 개체의 이름입니다. |
|
문자열로 개체의 형식 이름입니다. |
|
현재 지정된 개체와 연결된 사용자를 식별하는 SID 구조체입니다. 개체와 연결된 사용자가 없는 경우 lpnLengthNeeded |
[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에 도입됨) |
참고 항목
CreateDesktop
CreateWindowStation
GetUserObjectSecurity
OpenDesktop
OpenWindowStation
SetUserObjectInformation
SetUserObjectSecurity
USEROBJECTFLAGS