SetNtmsUIOptionsA 함수(ntmsapi.h)

  • 아티클

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

SetNtmsUIOptions 함수는 지정된 형식의 UI가 지정된 개체에 대해 전달되는 컴퓨터 이름 목록을 수정합니다.

구문

DWORD SetNtmsUIOptionsA(
  [in]  HANDLE            hSession,
  [in]  const LPNTMS_GUID lpObjectId,
  [in]  DWORD             dwType,
  [in]  DWORD             dwOperation,
  [out] LPCSTR            lpszDestination
);

매개 변수

[in] hSession

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

[in] lpObjectId

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

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

[in] dwType

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

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

[in] dwOperation

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

값 의미
NTMS_UIDEST_ADD
 목록에 새 대상(컴퓨터 이름)을 추가합니다.
NTMS_UIDEST_DELETE
 목록에서 대상을 제거합니다.
NTMS_UIDEST_DELETEALL
 목록에서 모든 대상을 지웁니다. 개체에 대한 UI가 생성되지 않습니다. 이 경우 대상 인수는 무시됩니다.

[out] lpszDestination

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

반환 값

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

값 의미
ERROR_ACCESS_DENIED
 하나 이상의 RSM 개체에 대한 액세스가 거부되었습니다.
ERROR_ALREADY_EXISTS
 지정된 대상이 목록에 이미 있습니다.
ERROR_INVALID_HANDLE
 세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_PARAMETER
 lpdwSize 또는 lpszDestination 포인터가 NULL이거나 lpObjectId 가 유효한 컨테이너가 아니거나 dwType 또는 dwOperation 이 세 가지 유효한 값 중 하나가 아닙니다.
ERROR_NOT_ENOUGH_MEMORY
 처리하는 동안 할당 오류가 발생했습니다.
ERROR_OBJECT_NOT_FOUND
 lpObjectId로 지정된 GUID는 데이터베이스에 있는 컴퓨터 또는 라이브러리 개체의 GUID가 아닙니다.
ERROR_SUCCESS
 함수가 성공했습니다.

설명

SetNtmsUIOptions에 대한 호출은 lpObjectId 및 dwType 매개 변수에 의해 결정된 특정 instance 대한 대상을 추가하거나 제거합니다.

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

보안 검사는 SetNtmsUIOptions를 호출할 때 수행됩니다. 컴퓨터 개체를 지정하면 컴퓨터를 수정할 수 있는 권한이 있어야 합니다. 라이브러리의 UI 요소를 수정할 때는 라이브러리 개체를 수정할 수 있는 권한이 있는 액세스 권한이 있어야 합니다.

대상 문자열은 검사하지 않습니다. SetNtmsUIOptions라는 컴퓨터에서 연결할 수 있는 컴퓨터가 아닌 대상 이름을 가진 에 대한 호출은 성공을 반환합니다. 빈 문자열에 대한 포인터는 로컬 머신을 의미하기 위해 사용됩니다.

참고

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

요구 사항

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

추가 정보

GetNtmsUIOptions

라이브러리 컨트롤 함수