다음을 통해 공유

UpdateNtmsOmidInfo 함수(ntmsapi.h)

  • 아티클

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

UpdateNtmsOmidInfo 함수는 새로 할당된 매체에 쓴 직후 레이블 정보로 RSM 데이터베이스를 업데이트합니다.

구문

DWORD UpdateNtmsOmidInfo(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       labelType,
  [in] DWORD       numberOfBytes,
  [in] LPVOID      lpBuffer
);

매개 변수

[in] hSession

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

[in] lpMediaId

논리 미디어 조각의 고유 식별자입니다.

[in] labelType

레이블 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
NTMS_OMID_TYPE_FILESYSTEM_INFO
 lpBuffer 매개 변수에는 NTMS_FILESYSTEM_INFO 구조체가 포함되어 있습니다. 이 플래그는 파일 시스템을 포함하는 미디어에 사용됩니다.
NTMS_OMID_TYPE_RAW_LABEL
 lpBuffer 매개 변수는 애플리케이션 레이블의 원시 바이트를 포함합니다. 이 플래그는 애플리케이션에 기록된 레이블이 포함된 미디어에 사용됩니다.

[in] numberOfBytes

lpBuffer 매개 변수에서 보낸 바이트 수입니다.

[in] lpBuffer

레이블 정보입니다. 이 매개 변수의 형식은 labelType 매개 변수의 값에 따라 달라집니다.

반환 값

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

값 의미
ERROR_ACCESS_DENIED
 하나 이상의 RSM 개체에 대한 액세스가 거부되었습니다.
ERROR_DATABASE_FAILURE
 데이터베이스 쿼리 또는 업데이트가 실패했습니다.
ERROR_INVALID_HANDLE
 hSession 매개 변수에 지정된 값이 잘못되었습니다.
ERROR_INVALID_MEDIA
 데이터베이스에서 논리 미디어 정의를 검색할 수 없습니다.
ERROR_INVALID_PARTITION
 데이터베이스에서 측면 정의를 검색할 수 없습니다.
ERROR_INVALID_PARAMETER
 lpMediaId 매개 변수는 NULL입니다.
ERROR_NOT_CONNECTED
 RSM 서비스에 연결할 수 없습니다.
ERROR_SUCCESS
 함수가 성공했습니다.

설명

애플리케이션은 UpdateNtmsOmidInfo 함수에서 제공하는 정보로 RSM을 업데이트하고 RSM은 데이터베이스의 정보를 확인합니다. 레이블 정보는 이 LMID와 연결된 쪽이 있는 RSM 데이터베이스에 저장됩니다.

RSM 서버에서 UpdateNtmsOmidInfo 함수를 실행해야 합니다. 이 함수를 원격으로 실행하면 오류가 발생합니다.

테이프 미디어의 경우 lpBuffer는 테이프에 방금 작성된 레이블이 있는 버퍼를 가리킵니다. 이 버퍼의 데이터는 각 MLL의 ClaimMediaLabel 진입점으로 직접 전달됩니다. 설치된 MLL 중 하나가 이 데이터의 유효한 레이블을 인식해야 합니다.

파일 시스템이 있는 미디어의 경우 lpBuffer 는 다음 구조를 포함하는 버퍼에 대한 포인터여야 합니다.


typedef struct {
    WCHAR   FileSystemType[64];
    WCHAR   VolumeName[256];
    DWORD   SerialNumber;
} NTMS_FILESYSTEM_INFO;

RSM은 이 파일 시스템 정보를 OMID로 사용합니다. 형식 유틸리티(LDM, 탐색기, format.com 등)는 이 호출과 동일한 기능을 효과적으로 수행합니다. 타사 파일 시스템 형식을 사용하여 자체 서식 또는 형식을 수행하는 애플리케이션은 파일 시스템 미디어에 대해 UpdateNtmsOmidInfo 만 호출하면 됩니다.

요구 사항

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

추가 정보

온-미디어 식별자 관리 함수