IAudioSystemEffectsPropertyStore::OpenUserPropertyStore 메서드(mmdeviceapi.h)

오디오 시스템 효과 사용자 속성 저장소를 엽니다.

구문

HRESULT OpenUserPropertyStore(
  DWORD          stgmAccess,
  IPropertyStore **propStore
);

stgmAccess

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

STGM_READ

STGM_WRITE

STGM_READWRITE

이 메서드를 사용하면 관리자 권한으로 실행되는 클라이언트가 읽기 전용, 쓰기 전용 또는 읽기/쓰기 액세스를 위해 저장소를 열 수 있습니다. 관리자 권한으로 실행되지 않는 클라이언트는 읽기 전용 액세스로 제한됩니다.

propStore

사용자 속성 저장소를 나타내는 IPropertyStore 에 대한 포인터를 받습니다.

다음을 포함하지만 이에 국한되지 않는 HRESULT를 반환합니다.

값	설명
S_OK	Success
E_NOTFOUND	호출이 존재하지 않는 속성 저장소를 열려고 합니다. 설명 부분을 참조하세요.
E_ACCESSDENIED	호출자가 지정된 stgmAccess 값에 대한 액세스가 거부되었습니다.

이 메서드는 컨텍스트 레지스트리 키에서만 기존 속성 저장소를 엽니다. 연결된 INF 파일에 키가 없으면 새 키를 만들지 않습니다. 아직 존재하지 않는 속성 저장소에 액세스하려고 하면 E_NOTFOUND 오류가 발생합니다.

오디오 드라이버와 함께 제공 될 수 있는 API (오디오 처리 개체)에 대 한 Windows 11 API에 대 한 자세한 내용은 참조 Windows 11 오디오 처리 개체에 대 한 API입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 빌드 22000
머리글	mmdeviceapi.h