GetNtmsObjectInformationW 함수(ntmsapi.h)
[이동식 스토리지 관리자 더 이상 Windows 7 및 Windows Server 2008 R2를 사용할 수 없습니다.]
GetNtmsObjectInformation 함수는 지정된 개체에 대한 개체의 정보 구조를 반환합니다.
통사론
DWORD GetNtmsObjectInformationW(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[out] LPNTMS_OBJECTINFORMATIONW 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 구조체의 모든 쓰기 가능한 멤버를 업데이트하므로 애플리케이션은 모든 쓰기 가능한 멤버에 대한 값을 제공합니다.
다음은 특별한 액세스 권한이 필요한 개체 목록입니다.
| 객체 | 접근 |
|---|---|
| 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 필요합니다. |
메모
ntmsapi.h 헤더는 GETNtmsObjectInformation을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |
참고 항목
GetNtmsObjectSecurity
SetNtmsObjectInformation