IMMDevice::OpenPropertyStore 메서드(mmdeviceapi.h)

  • 아티클

OpenPropertyStore 메서드는 디바이스의 속성 저장소에 대한 인터페이스를 검색합니다.

구문

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

매개 변수

[in] stgmAccess

스토리지 액세스 모드입니다. 이 매개 변수는 읽기 모드, 쓰기 모드 또는 읽기/쓰기 모드에서 속성 저장소를 열지 여부를 지정합니다. 이 매개 변수를 다음 STGM 상수 중 하나로 설정합니다.

STGM_READ

STGM_WRITE

STGM_READWRITE

이 메서드를 사용하면 관리자 권한으로 실행되는 클라이언트가 읽기 전용, 쓰기 전용 또는 읽기/쓰기 액세스를 위해 저장소를 열 수 있습니다. 관리자 권한으로 실행되지 않는 클라이언트는 읽기 전용 액세스로 제한됩니다. STGM 상수에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

[out] ppProperties

메서드가 디바이스 속성 저장소의 IPropertyStore 인터페이스 주소를 쓰는 포인터 변수에 대한 포인터입니다. 이 메서드를 통해 호출자는 인터페이스에 대해 계산된 참조를 가져옵니다. 호출자는 인터페이스의 Release 메서드를 호출하여 더 이상 필요하지 않은 경우 인터페이스를 해제 할 책임이 있습니다. OpenPropertyStore 호출이 실패하면 *ppProperties는 NULL입니다. IPropertyStore에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.

반환 코드 설명
E_INVALIDARG
 매개 변수 stgmAccess 는 유효한 액세스 모드가 아닙니다.
E_POINTER
 매개 변수 ppProperties 는 NULL입니다.
E_OUTOFMEMORY
 메모리가 부족합니다.

설명

일반적으로 디바이스의 속성 저장소의 속성은 관리, 시스템 또는 서비스 기능을 수행하지 않는 클라이언트에 대해 읽기 전용입니다.

OpenPropertyStore 메서드를 호출하는 코드 예제는 다음 topics 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mmdeviceapi.h

참고 항목

IMMDevice 인터페이스