IObexDevice::Connect

9/8/2008

Este método inicia uma transação OBEX com um remoto específico dispositivo.

Syntax

HRESULT Connect(
  LPCWSTR pszPassword,
  DWORD dwCapability,
  IHeaderCollection* pHeaders
);

Parameters

• pszPassword
  [no] Uma senha para a conexão (opcional). Se uma senha é desnecessária, defina este parâmetro como NULL.

• dwCapability
  [no] Reservado. Defina como 0.

• pHeaders
  [no] Aponta para a lista cabeçalho-held capazes de oferecer o servidor com informações adicionais. De exemplo, se a lista contém o cabeçalho de destino, em seguida, o cliente poderá usá-lo recuperar a UUID do servidor. Se o cabeçalho de destino não está incluído na lista, em seguida, a conexão é feita para o serviço usar como padrão, servidor da caixa de entrada.

Return Value

Esse método retorna um dos seguinte valores.

Return valor	Descrição
S_OK	A conexão foi estabelecida com êxito.
E_FAIL	Falha de conexão.
OBEX_E_CONNECTION_NOT_ACCEPTED	Falha de autenticação. A senha é provavelmente incorreta.

Remarks

Se uma senha não for especificada e o servidor requer uma senha, uma callback é feita para a interface registrado no objeto OBEX principal. Se nenhuma interface está registrado para retornos de chamada e uma senha é exigido, o método falhar. Se a senha não for especificada, a senha especificado em IObexDevice::SetPassword.

Observação

Este método não faz a conexão mas ele envia um novo pacote Connect.O físico transporte talvez já exista e seja reutilizado.

Para conectar a um personalizado serviço, referir a esse serviço usando seu associado GUID.

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

IObexDevice::SetPassword
IObexDevice:IUnknown
OBEX Interfaces

Concepts

Client Support