Compartir a través de

Método IPortableDeviceResources::CreateResource (portabledeviceapi.h)

  • Artículo

El método CreateResource crea un recurso.

Sintaxis

HRESULT CreateResource(
  [in]  IPortableDeviceValues *pResourceAttributes,
  [out] IStream               **ppData,
  [out] DWORD                 *pdwOptimalWriteBufferSize,
  [out] LPWSTR                *ppszCookie
);

Parámetros

[in] pResourceAttributes

Puntero a los siguientes atributos de parámetro de objeto.

Atributo Descripción
WPD_OBJECT_NAME El nombre del objeto.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE Tamaño total del flujo de datos de recursos.
WPD_RESOURCE_ATTRIBUTE_FORMAT Formato del flujo de datos de recursos.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY Clave de recurso.

[out] ppData

Puntero a una secuencia en la que el autor de la llamada puede escribir datos de recursos.

[out] pdwOptimalWriteBufferSize

Puntero a un valor que especifica el tamaño óptimo del búfer al escribir en la secuencia. Este parámetro es opcional.

[out] ppszCookie

Puntero a una cookie que identifica la solicitud de creación de recursos. Este parámetro es opcional.

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.
E_POINTER
 Al menos uno de los argumentos era un puntero NULL .

Comentarios

Cuando una aplicación llama a este método, debe especificar los atributos de recurso y debe escribir los datos necesarios en la secuencia que devuelve este método.

No se crea un recurso cuando el método devuelve; se crea cuando la aplicación confirma los datos llamando al método Commit en la secuencia en la que ppData apunta.

Para cancelar la transferencia de datos a un recurso, la aplicación debe llamar al método Revert en la secuencia en la que ppData apunta. Una vez cancelada la transferencia, la aplicación debe invocar IUnknown::Release para cerrar la secuencia.

Requisitos

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

Consulte también

IPortableDeviceResources (Interfaz)