Метод IStillImageW::SetDeviceValue (sti.h)
Метод IStillImage::SetDeviceValue задает сведения о реестре для указанного устройства с изображением.
Синтаксис
HRESULT SetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
DWORD Type,
[in] LPBYTE pData,
DWORD cbData
);
Параметры
[in] pwszDeviceName
Предоставленный вызывающим элементом указатель на строку, представляющую имя внутреннего устройства, полученное путем вызова IStillImage::GetSTILaunchInformation или IStillImage::GetDeviceList.
[in] pValueName
Предоставленный вызывающим элементом указатель на строку, представляющую имя значения реестра.
Type
Предоставленный вызывающим REG_ типом значения реестра с префиксом. Дополнительные сведения см. в разделе RegSetValueEx документации по Microsoft Windows SDK.
[in] pData
Предоставленный вызывающим элементом указатель на данные для хранения.
cbData
Предоставленный вызывающим абонентом размер данных в байтах, на которые указывает pData. Для строк, завершающихся значением NULL, добавьте символ NULL.
Возвращаемое значение
Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.
Комментарии
Цель метода IStillImage::SetDeviceValue заключается в том, чтобы задать значения для записей реестра, относящихся к конкретному устройству, для устройств с неподвижным образом. Метод вызывает RegSetValueEx (описан в документации по Microsoft Windows SDK).
Перед вызовом IStillImage::SetDeviceValue клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | sti.h (включая Sti.h) |