다음을 통해 공유

GetNtmsUIOptionsW 함수(ntmsapi.h)

  • 아티클

[이동식 스토리지 관리자 더 이상 Windows 7 및 Windows Server 2008 R2를 사용할 수 없습니다.]

GetNtmsUIOptions 함수는 지정된 형식의 사용자 인터페이스가 지정된 개체에 대해 전달되는 컴퓨터 이름 목록을 가져옵니다. GetNtmsUIOptions 호출은 lpObjectId 결정된 인스턴스의 대상 목록을 반환하고 dwType 매개 변수를 .

지정된 인스턴스의 목록에 대상이 없으면 함수는 목록 길이 0과 함께 ERROR_SUCCESS 반환합니다.

통사론

DWORD GetNtmsUIOptionsW(
  [in]      HANDLE            hSession,
  [in]      const LPNTMS_GUID lpObjectId,
  [in]      DWORD             dwType,
  [out]     LPWSTR            lpszDestination,
  [in, out] LPDWORD           lpdwBufSize
);

매개 변수

[in] hSession

OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.

[in] lpObjectId

UI가 리디렉션되는 개체의 고유 식별자입니다. 개체는 이벤트의 원본이 될 수 있는 컨테이너여야 합니다. 개체는 애플리케이션(애플리케이션에 의해 트리거되는 탑재 요청), 라이브러리(배출에 대한 응답으로 문 열기 요청) 또는 컴퓨터(컴퓨터와 관련된 모든 UI)일 수 있습니다.

컴퓨터 컨테이너를 지정하려면 이동식 스토리지 관리자의 컴퓨터 개체 GUID가 있는 버퍼를 가리키도록 lpObjectId 포인터를 설정합니다. 특정 라이브러리를 지정하려면 라이브러리의 GUID를 사용하여 버퍼를 가리키도록 설정합니다. 애플리케이션을 지정하려면 NULL 포인터를 전달합니다. 애플리케이션의 ID는 hSession사용되는 세션에 의해 결정됩니다. 애플리케이션은 여러 세션을 동시에 열 수 있습니다. 이 경우 값 집합은 hSession 세션에만 적용됩니다.

[in] dwType

이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

값 의미
NTMS_UITYPE_INFO
 정보를 제공하는 UI 메시지입니다. 여기에는 진행률을 나타내는 작업 큐 항목이 포함됩니다. 예를 들어 탑재 요청입니다.
NTMS_UITYPE_REQ
 요청인 UI 메시지입니다. 여기에는 미디어를 처리하는 연산자 요청이 포함됩니다. 예를 들어 새 미디어를 삽입하는 요청입니다.
NTMS_UITYPE_ERR
 오류 정보를 제공하는 UI 메시지입니다. 여기에는 오류 알림과 관련된 운영자 요청이 포함됩니다. 예를 들어 드라이브를 정리하는 요청입니다.

[out] lpszDestination

UI가 리디렉션되는 컴퓨터의 이름을 반환하는 다중 문자열입니다. 이 매개 변수는 NULL수 없습니다.

[in, out] lpdwBufSize

TCHAR대상 문자열의 크기입니다.

반환 값

이 함수는 다음 값 중 하나를 반환합니다.

값 의미
ERROR_ACCESS_DENIED
 하나 이상의 RSM 개체에 대한 액세스가 거부되었습니다.
ERROR_INSUFFICIENT_BUFFER
 lpdwSize 지정된 버퍼 크기가 찾은 대상에 비해 너무 작습니다. 이 함수는 lpdwSize실제 크기를 반환합니다.
ERROR_INVALID_HANDLE
 세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_PARAMETER
 lpdwSize 또는 lpszDestination 매개 변수는 NULL또는 lpObjectId 유효한 컨테이너가 아니거나 dwType 세 가지 유효한 값 중 하나가 아닙니다.
ERROR_NOT_ENOUGH_MEMORY
 처리하는 동안 할당 오류가 발생했습니다.
ERROR_OBJECT_NOT_FOUND
 lpObjectId 지정한 GUID는 데이터베이스에 있는 컴퓨터 또는 라이브러리 개체의 GUID가 아닙니다.
ERROR_SUCCESS
 함수가 성공했습니다.

발언

GetNtmsUIOptions 호출은 lpObjectId 결정된 특정 인스턴스의 대상 목록을 반환하고 dwType 매개 변수를 .

  NTMS_UITYPE_INFO NTMS_UITYPE_REQ NTMS_UITYPE_ERR
신청 이 애플리케이션에서 생성된 작업 항목의 작업 항목 진행률 UI를 표시합니다. 이 애플리케이션에서 수행한 작업에 의해 생성된 연산자 요청에 대한 운영자 요청 UI를 표시합니다. 정의. 애플리케이션은 이러한 종류의 오류 이벤트를 발생시킬 수 없습니다.
도서관 이 라이브러리와 연결된 작업 항목의 작업 항목 진행률 UI를 표시합니다. 이 라이브러리와 연결된 요청에 대한 UI를 표시합니다. 이 라이브러리와 연결된 오류에 대한 UI를 표시합니다.
컴퓨터 이 컴퓨터에서 실행되는 RSM의 이 인스턴스에 정보 UI를 표시합니다. 이 RSM 인스턴스에서 요청 유형 UI를 표시합니다. 이 RSM 인스턴스에 오류 유형 UI를 표시합니다.
 

메모

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

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ntmsapi.h
라이브러리 Ntmsapi.lib
DLL Ntmsapi.dll

참고 항목

라이브러리 컨트롤 함수

SetNtmsUIOptions