Método IPortableDeviceManager::GetDeviceProperty (portabledeviceapi.h)

Recupera un valor de propiedad almacenado por el dispositivo en el equipo. (Estas no son propiedades estándar definidas por dispositivos portátiles de Windows).

Sintaxis

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

Parámetros

[in] pszPnPDeviceID

Puntero a una cadena terminada en null que contiene el identificador de Plug and Play del dispositivo. Puede recuperar una lista de Plug and Play nombres de todos los dispositivos conectados al equipo mediante una llamada a GetDevices.

[in] pszDevicePropertyName

Puntero a una cadena terminada en null que contiene el nombre de la propiedad que se va a solicitar. Estos son nombres de propiedad personalizados definidos por un fabricante de dispositivos.

[in, out] pData

Búfer asignado por el autor de la llamada para contener los datos recuperados. Para obtener el tamaño necesario, llame a este método con este parámetro establecido en NULL y pcbData establecido en cero y el tamaño necesario se recuperará en pcbData. Esta llamada también devolverá un error que se puede omitir. Consulte Valores devueltos.

[in, out] pcbData

Tamaño del búfer asignado o devuelto por pData, en bytes.

[in, out] pdwType

Constante que describe el tipo de datos devueltos en pData. Los valores de este parámetro son los mismos tipos que se usan para describir el parámetro lpType de la función RegQueryValueEx del SDK de plataforma.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	El búfer proporcionado no es lo suficientemente grande como para contener los datos solicitados. (Este resultado siempre se devuelve cuando pData es NULL. Puede omitir este resultado si llama al método para recuperar el tamaño de búfer necesario. Consulte la descripción del parámetro pData ).
E_POINTER	Al menos uno de los argumentos necesarios era un puntero NULL .

Comentarios

Estos valores de propiedad se almacenan en la instalación del dispositivo o los almacena un dispositivo durante la operación para que se puedan conservar entre sesiones de conexión. Una aplicación debe conocer el nombre exacto de la propiedad , que el propio dispositivo especifica; por lo tanto, este método está diseñado para ser utilizado por los desarrolladores de dispositivos que crean sus propias aplicaciones.

Para obtener las propiedades dispositivos portátiles de Windows del objeto de dispositivo, llame a IPortableDeviceProperties::GetValues y especifique el objeto de dispositivo con WPD_DEVICE_OBJECT_ID.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceManager (interfaz)

IPortableDeviceManager::GetDevices