GetNtmsObjectInformation 함수(ntmsapi.h)
[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]
GetNtmsObjectInformation 함수는 지정된 개체에 대한 개체의 정보 구조를 반환합니다.
구문
DWORD GetNtmsObjectInformation(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[out] LPNTMS_OBJECTINFORMATION lpInfo
);
매개 변수
[in] hSession
OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.
[in] lpObjectId
RSM 개체의 고유 식별자입니다.
[out] lpInfo
개체 정보를 수신하는 NTMS_OBJECTINFORMATION 구조체에 대한 포인터입니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
개체 또는 해당 컨테이너에 대한 NTMS_USE_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
Windows XP: 액세스 권한이 필요하지 않습니다. |
|
세션 핸들이 없거나 잘못되었습니다. |
|
개체 ID 또는 정보 구조가 없거나 개체 정보 크기 또는 개체 형식이 잘못되었습니다. |
|
처리하는 동안 할당 오류가 발생했습니다. |
|
개체 ID가 잘못되었습니다. |
|
함수가 성공했습니다. |
설명
정보 구조의 정보 크기와 형식은 GetNtmsObjectInformation 함수를 사용하기 전에 lpInfo 매개 변수에서 올바르게 설정해야 합니다.
예기치 않은 결과를 방지하려면 애플리케이션이 SetNtmsObjectInformation 함수를 호출하기 전에 GetNtmsObjectInformation 함수를 호출해야 합니다. SetNtmsObjectInformation 함수는 NTMS_OBJECTINFORMATION 구조의 모든 쓰기 가능한 멤버를 업데이트하므로 애플리케이션은 모든 쓰기 가능한 멤버에 대한 값을 제공해야 합니다.
다음은 특별한 액세스 권한이 필요한 개체 목록입니다.
| Object | Access |
|---|---|
| NTMS_CHANGER | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_CHANGER_TYPE | 컴퓨터에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_COMPUTER | 컴퓨터에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_DRIVE | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_DRIVE_TYPE | 컴퓨터에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_IEDOOR | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_IEPORT | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_LIBRARY | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_LIBREQUEST | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_LOGICAL_MEDIA | 논리 미디어의 미디어 풀에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_MEDIA_TYPE | 컴퓨터에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_OPREQUEST | 컴퓨터에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_PARTITION | 측면의 미디어 풀에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_PHYSICAL_MEDIA | 미디어 풀에 NTMS_USE_ACCESS 필요합니다. |
| NTMS_STORAGESLOT | 라이브러리에 NTMS_USE_ACCESS 필요합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |