Método IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Artigo
08/25/2023

O método GetFunctionalObjects recupera todos os objetos funcionais que correspondem a uma categoria especificada no dispositivo.

Sintaxe

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parâmetros

[in] Category

Um REFGUID que especifica a categoria a ser pesquisada. Isso pode ser WPD_FUNCTIONAL_CATEGORY_ALL para retornar todos os objetos funcionais.

[out] ppObjectIDs

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDevicePropVariantCollection que contém as IDs de objeto dos objetos funcionais como cadeias de caracteres (tipo VT_LPWSTR nos itens PROPVARIANT recuperados). Se nenhum objeto do tipo solicitado for encontrado, essa será uma coleção vazia (não NULL). O chamador deve liberar essa interface quando terminar de usá-la.

Valor retornado

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.

Comentários

Essa operação geralmente é rápida, pois o driver não precisa executar uma enumeração de conteúdo completa e o número de objetos funcionais recuperados normalmente é menor que 10. Se nenhum objeto do tipo solicitado for encontrado, esse método não retornará um erro, mas retornará uma coleção vazia para ppObjectIDs.