IObex::EnumDevices

9/8/2008

Esse método retorna um ponteiro para o IDeviceEnum interface que enumera a lista de dispositivos conhecidos.

Syntax

HRESULT EnumDevices(
  IDeviceEnum** ppDeviceEnum, 
  REFCLSID uuidTransport
);

Parameters

• ppDeviceEnum
  [out] Ponteiro para o IDeviceEnum interface.

• uuidTransport
  [no] Especifica o UUID do transporte específico fazer enumeração dispositivo. Isso permite enumeração dispositivo seja limitada a um transporte se assim desejar. Se a enumeração dispositivo para todos os transportes for desejada, esse valor deve ser definido para CLSID_NULL. O disponível dispositivo tipos listados na seguinte tabela.

  Valor	Descrição
  BthTransport	Um dispositivo que usa Bluetooth para se comunicar com outros dispositivos.
  GUID_NULL	Todos os dispositivos.
  HeaderCollection	A coleção cabeçalho de um dispositivo.
  IpTransport	Um dispositivo que usa TCP/IP para se comunicar com outros dispositivos.
  IrdaTransport	Um dispositivo que usa IRdA para se comunicar com outros dispositivos.
  OBEX	Um OBEX-dispositivo classe.
  PropertyBag	Conjunto de propriedade de um dispositivo.

Return Value

Esse método retorna o padrão valores E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, e E_FAIL, as well as o seguinte:

• S_OK
  O método foi concluído com êxito.

Remarks

Quando síncrono enumeração dispositivo estiver sendo usada, este método classifica as informações retornadas. Para usar esse método, iniciar a enumeração primeiro usando o IOBex::StartDeviceEnum método. Para parar a enumeração, use o IObex::StopDeviceEnum método. Depois que essas duas operações tem sido executar, use IObex::EnumDevices Para agrupar informações de dispositivo retornado.

Este método não deve ser chamado antes chamado de IObex::StartDeviceEnum método ou ele retornará uma falha.

Se o dispositivo foi colocado no cache pelo mecanismo de descoberta abaixo OBEX, talvez não seja conectável.

Requirements

Header	obex.h, obex.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IObex::StartDeviceEnum
IObex:IUnknown
IDeviceEnum:IUnknown
OBEX Interfaces