WapOpen

9/19/2008

Essa função abrirá um identificador para enviar uma mensagem WAP.

Syntax

HRESULT WapOpen(
  const WAP_LAYER wlLayer,
  const DWORD dwLocalPort,
  WAP_HANDLE* const pwhHandle,
  HANDLE* const phMessageAvailableEvent 
);

Parameters

• wlLayer
  [no] A WAP_LAYER estrutura contendo a camada WAP para o qual o identificador aberto.

• dwLocalPort
  [no] Porta local para usar. Esta porta é semelhante a uma porta soquetes e é usada por aplicativos WAP no envio e recebimento PDUs que. Se a porta solicitada já está em uso, a função falhará. Se um local específico porta não é exigido, um valor de 0 pode ser passados para este parâmetro.

• pwhHandle
  [out] Ponteiro para o identificador para aberto. Esse identificador será usado em chamadas subseqüentes função WAP.

• phMessageAvailableEvent
  [out] Ponteiro para o identificador para um evento para sinalizar quando chega um novo pacote WAP. O provedor WAP cria esse evento e destrói-lo via WapClose. Para obter mais informações, consulte os "Comentários" seção.

Return Value

Retorna S_OK se bem-sucedido. Se malsucedido, essa função retorna o padrão valores E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL.

Remarks

Somente um cliente WAP pode ter um identificador ligado a um local específico porta em um tempo. O atual identificador evento será destruído em um chamar para WapClose. Comportamento está indefinido se o usuário destrói o identificador evento diretamente, instead of por chamado WapClose.

Aplicativos só devem esperar sobre o evento por chamado adequado (funções Microsoft Win32® APIWaitForSingleObject, WaitForMultipleObjectse assim por diante). Eles não devem deve usar o identificador com quaisquer outros função da API, de exemplo, SetEvent, ResetEvent.

Requirements

Header	wap.h
Library	Wap.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

WapClose
WAP_LAYER

Concepts

WAP Functions