[Function Discovery는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
함수 instance 대한 속성 저장소를 엽니다. 속성 저장소에는 이름, 아이콘, 설치 날짜 및 기타 정보와 같은 함수 instance 대한 메타데이터가 포함되어 있습니다.
구문
HRESULT OpenPropertyStore(
[in] DWORD dwStgAccess,
[out] IPropertyStore **ppIPropertyStore
);
매개 변수
[in] dwStgAccess
열린 스트림에 할당할 액세스 모드입니다. 이 메서드의 경우 다음과 같은 액세스 모드가 지원됩니다.
STGM_READ
STGM_READWRITE
STGM_WRITE
[out] ppIPropertyStore
IPropertyStore 인터페이스 포인터에 대한 포인터입니다.
반환 값
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
호출자가 액세스 권한이 부족하거나 검색 공급자가 해당 속성 저장소에 대한 쓰기 액세스를 허용하지 않기 때문에 메서드가 쓰기 가능한 속성 저장소를 열 수 없습니다. |
|
dwStgAccess 값이 잘못되었습니다. |
|
ppIPropertyStore는 잘못된 메모리를 가리킵니다. |
|
메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
설명
함수 instance 한 번에 하나의 속성 저장소만 열 수 있습니다. 동일한 함수 instance OpenPropertyStore가 두 번 호출되면 두 ppIPropertyStore 포인터가 모두 동일한 속성 저장소를 가리킵니다. 또한 액세스 모드( dwStgAccess 매개 변수로 지정됨)는 가장 최근의 OpenPropertyStore 호출에 의해 결정됩니다. 애플리케이션은 릴리스 를 호출하여 다른 속성을 열기 전에 속성 저장소를 닫아야 합니다.
OpenPropertyStore는 제거된 디바이스에 대한 속성 저장소를 반환할 수 있습니다. 이 경우 저장소의 속성 키는 비어 있습니다. 이 상황은 디바이스의 devnode가 삭제되었지만 디바이스의 함수 instance 연결된 속성 저장소에 여전히 액세스할 수 있는 경우에 발생할 수 있습니다. 이 상황은 거의 발생하지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |