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
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | sti.h (include Sti.h) |