IPortableDeviceManager::GetDeviceProperty 메서드(portabledeviceapi.h)
컴퓨터의 디바이스에 저장된 속성 값을 검색합니다. (Windows 이식 가능한 디바이스에서 정의한 표준 속성이 아닙니다.)
구문
HRESULT GetDeviceProperty(
[in] LPCWSTR pszPnPDeviceID,
[in] LPCWSTR pszDevicePropertyName,
[in, out] BYTE *pData,
[in, out] DWORD *pcbData,
[in, out] DWORD *pdwType
);
매개 변수
[in] pszPnPDeviceID
디바이스의 플러그 앤 플레이 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. GetDevices를 호출하여 컴퓨터에 연결된 모든 디바이스의 플러그 앤 플레이 이름 목록을 검색할 수 있습니다.
[in] pszDevicePropertyName
요청할 속성의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 디바이스 제조업체에서 정의한 사용자 지정 속성 이름입니다.
[in, out] pData
검색된 데이터를 저장할 호출자가 할당한 버퍼입니다. 필요한 크기를 얻으려면 이 매개 변수를 NULL 로 설정하고 pcbData 를 0으로 설정하여 이 메서드를 호출하면 필요한 크기가 pcbData에서 검색됩니다. 이 호출은 무시될 수 있는 오류도 반환합니다. 반환 값을 참조하세요.
[in, out] pcbData
pData에서 할당되거나 반환된 버퍼의 크기(바이트)입니다.
[in, out] pdwType
pData에서 반환되는 데이터 형식을 설명하는 상수입니다. 이 매개 변수의 값은 Platform SDK 함수 RegQueryValueEx의 lpType 매개 변수를 설명하는 데 사용되는 것과 동일한 형식입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
제공된 버퍼가 요청된 데이터를 저장할 만큼 크지 않습니다. (이 결과는 pData 가 NULL일 때 항상 반환됩니다. 메서드를 호출하여 필요한 버퍼 크기를 검색하는 경우 이 결과를 무시할 수 있습니다. pData 매개 변수에 대한 설명을 참조하세요.) |
|
필요한 인수 중 하나 이상이 NULL 포인터였습니다. |
설명
이러한 속성 값은 디바이스 설치에 저장되거나 작업 중에 디바이스에 의해 저장되므로 연결 세션 간에 유지할 수 있습니다. 애플리케이션은 디바이스 자체에 의해 지정된 속성의 정확한 이름을 알고 있어야 합니다. 따라서 이 메서드는 자체 애플리케이션을 만드는 디바이스 개발자가 사용하려고 합니다.
디바이스 개체에서 Windows 이식 가능한 디바이스 속성을 얻으려면 IPortableDeviceProperties::GetValues를 호출하고 WPD_DEVICE_OBJECT_ID 사용하여 디바이스 개체를 지정합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | portabledeviceapi.h |
라이브러리 | PortableDeviceGUIDs.lib |