Método IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs (portabledeviceapi.h)

O método GetObjectIDsFromPersistentUniqueIDs recupera a ID do objeto atual de um ou mais objetos, considerando suas IDs exclusivas persistentes (PUIDs).

Sintaxe

HRESULT GetObjectIDsFromPersistentUniqueIDs(
  [in]  IPortableDevicePropVariantCollection *pPersistentUniqueIDs,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parâmetros

[in] pPersistentUniqueIDs

Ponteiro para uma interface IPortableDevicePropVariantCollection que contém um ou mais valores de cadeia de caracteres PUID (ID exclusiva persistente) (tipo VT_LPWSTR).

[out] ppObjectIDs

Ponteiro para um ponteiro de interface IPortableDevicePropVariantCollection que contém as IDs de objeto recuperadas, como tipo VT_LPWSTR. As IDs recuperadas estarão na mesma ordem que as PUIDs enviadas; se um valor não puder ser encontrado, ele será indicado por uma cadeia de caracteres vazia. O chamador deve liberar essa interface quando terminar com ela.

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 necessários era um ponteiro NULL .

Comentários

As IDs de Objeto de Dispositivos Portáteis do Windows são exclusivas em todo o dispositivo, mas podem ser diferentes entre as sessões. Uma ID de Objeto pode ser alterada quando o aplicativo se reconecta ao dispositivo.

Determinados aplicativos, como mecanismos de sincronização, exigem uma maneira de identificar o objeto entre sessões de conexão. Cada objeto tem uma propriedade WPD_OBJECT_PERSISTENT_UNIQUE_ID, que indica um identificador persistente entre sessões. Os aplicativos podem ler e salvar essa propriedade em sua sessão inicial chamando o método Properties .

Exemplos

Para obter um exemplo de como usar esse método, consulte Recuperando um identificador de objeto de um identificador exclusivo persistente

Requisitos

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

Confira também

IPortableDeviceContent Interface

Recuperando um identificador de objeto de um identificador exclusivo persistente