IStillImageW::SetDeviceValue method (sti.h)

The IStillImage::SetDeviceValue method sets registry information for a specified still image device.

Syntax

HRESULT SetDeviceValue(
  [in] LPWSTR pwszDeviceName,
  [in] LPWSTR pValueName,
       DWORD  Type,
  [in] LPBYTE pData,
       DWORD  cbData
);

Parameters

[in] pwszDeviceName

Caller-supplied pointer to a string representing an internal device name, obtained by calling IStillImage::GetSTILaunchInformation or IStillImage::GetDeviceList.

[in] pValueName

Caller-supplied pointer to a string representing a registry value name.

Type

Caller-supplied REG_-prefixed registry value type. For more information, see RegSetValueEx in the Microsoft Windows SDK documentation.

[in] pData

Caller-supplied pointer to the data to be stored.

cbData

Caller-supplied size, in bytes, of the data pointed to by pData. For NULL-terminated strings, include the NULL character.

Return value

If the operation succeeds, the method returns S_OK. Otherwise, it returns one of the STIERR-prefixed error codes defined in stierr.h.

Remarks

The purpose of the IStillImage::SetDeviceValue method is to set values for device-specific Registry Entries for Still Image Devices. The method calls RegSetValueEx (described in the Microsoft Windows SDK documentation).

Before calling IStillImage::SetDeviceValue, clients of the IStillImage COM interface must call IStillImage::StiCreateInstance to obtain an IStillImage interface pointer.

Requirements

See also

IStillImage::GetDeviceValue

IStillImageW