IDiscFormat2RawCD::p ut_ClientName 메서드(imapi2.h)

  • 아티클

클라이언트의 이름을 설정합니다.

구문

HRESULT put_ClientName(
  [in] BSTR value
);

매개 변수

[in] value

클라이언트 애플리케이션의 이름입니다. NULL 또는 빈 문자열일 수 없습니다.

반환 값

S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.

반환 코드 설명
E_OUTOFMEMORY
 필요한 메모리를 할당하지 못했습니다.

값: 0x8007000E
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID
 클라이언트 이름이 잘못되었습니다.

값: 0xC0AA0604
E_IMAPI_DF2RAW_WRITE_IN_PROGRESS
 현재 쓰기 작업이 진행 중입니다.

값: 0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_PREPARED
 요청된 작업은 미디어가 "준비"되었지만 릴리스되지 않은 경우 유효하지 않습니다.

값: 0xC0AA0603

설명

이 이름은 쓰기 작업이 디바이스에 대한 단독 액세스를 요청할 때 사용됩니다. IDiscRecorder2::get_ExclusiveAccessOwner 속성에는 잠금이 있는 클라이언트의 이름이 포함됩니다.

쓰기 작업 중에 CDROM 디바이스에 대한 읽기/쓰기 액세스 권한이 있는 애플리케이션은 IOCTL_CDROM_EXCLUSIVE_ACCESS(쿼리) 제어 코드(Microsoft DDK(Windows 드라이버 개발 키트) 참조)를 사용하여 이름에 액세스할 수 있으므로 이름에서 이 인터페이스를 사용하여 미디어에 쓰는 프로그램을 식별하는 것이 중요합니다. 이름은 IOCTL_CDROM_EXCLUSIVE_ACCESS 제어 코드에서 요구하는 것과 동일한 문자 집합으로 제한됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imapi2.h

추가 정보

IDiscFormat2RawCD

IDiscFormat2RawCD::get_ClientName