Метод 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 в документации по пакету SDK для Microsoft Windows.

[in] pData

Вызывающий указатель на данные, которые нужно сохранить.

cbData

Указанный вызывающим объект размером данных в байтах, на которые указывает pData. Для строк, завершающих значение NULL, добавьте символ NULL.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Целью метода IStillImage::SetDeviceValue является установка значений для записей реестра, относящихся к устройству, реестра для устройств по-прежнему. Метод вызывает RegSetValueEx (описано в документации по пакету SDK для Microsoft Windows).

Перед вызовом IStillImage::SetDeviceValueклиенты интерфейса IStillImage IStillImage должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Требования

См. также

IStillImage::GetDeviceValue

IStillImageW