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

O método CreateResource cria um recurso.

Sintaxe

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

Parâmetros

[in] pResourceAttributes

Ponteiro para os atributos de parâmetro de objeto a seguir.

Atributo	Descrição
WPD_OBJECT_NAME	O nome do objeto.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE	O tamanho total do fluxo de dados do recurso.
WPD_RESOURCE_ATTRIBUTE_FORMAT	O formato do fluxo de dados do recurso.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY	A chave de recurso.

[out] ppData

Ponteiro para um fluxo no qual o chamador pode gravar dados de recurso.

[out] pdwOptimalWriteBufferSize

Ponteiro para um valor que especifica o tamanho ideal do buffer ao gravar no fluxo. Esse parâmetro é opcional.

[out] ppszCookie

Ponteiro para um cookie que identifica a solicitação de criação de recurso. Esse parâmetro é opcional.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos argumentos era um ponteiro NULL .

Comentários

Quando um aplicativo chama esse método, ele deve especificar os atributos de recurso e deve gravar os dados necessários no fluxo que esse método retorna.

Um recurso não é criado quando o método retorna; ele é criado quando o aplicativo confirma os dados chamando o método Commit no fluxo no qual ppData aponta.

Para cancelar a transferência de dados para um recurso, o aplicativo deve chamar o método Revert no fluxo no qual ppData aponta. Depois que a transferência for cancelada, o aplicativo deverá invocar IUnknown::Release para fechar o fluxo.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceResources Interface