Метод IStillImageW::GetDeviceValue (sti.h)

Метод IStillImage::GetDeviceValue возвращает сведения о реестре, связанные с указанным устройством с неподвижным образом.

Синтаксис

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

Параметры

[in] pwszDeviceName

Предоставленный вызывающим элементом указатель на строку, представляющую имя внутреннего устройства, полученное путем вызова IStillImage::GetSTILaunchInformation или IStillImage::GetDeviceList.

[in] pValueName

Предоставленный вызывающим элементом указатель на строку, представляющую имя значения реестра.

[out] pType

Получает константу, представляющую тип данных возвращаемого значения реестра.

[out] pData

Предоставленный вызывающим объектом указатель на буфер для получения возвращаемого значения.

[in, out] cbData

Предоставленный вызывающим объектом размер буфера в байтах, на который указывает pData. Метод изменяет это значение для представления размера возвращаемых данных. Если указанный размер буфера слишком мал, метод предоставляет необходимый размер буфера и возвращает код ошибки.

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

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

Комментарии

Метод IStillImage::GetDeviceValue предназначен для возврата значений, которые в настоящее время назначены записям реестра для устройств с изображением. Метод вызывает RegQueryValueEx (описано в документации по Microsoft Windows SDK).

Метод IStillImage::GetDeviceValue может возвращать строку ANSI или Юникод. Он может возвращать строку в Юникоде, только если ваш код построен как Юникод с определением Юникода.

Перед вызовом IStillImage::GetDeviceValue клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .

Требования

См. также раздел

IStillImage::SetDeviceValue

IStillImageW