WPUCreateSocketHandle

9/8/2008

Essa função cria um novo identificador Soquete.

Syntax

SOCKET WPUCreateSocketHandle(
  DWORD dwCatalogEntryId,
  DWORD_PTR dwContext,
  LPINT lpErrno 
);

Parameters

• dwCatalogEntryId
  [no] Descritor identificando o provedor serviço chamado. Este parâmetro é usado para determinar qual provedor será chamado para operações que são executadas sobre o Soquete, such as WSASend e WSARecv.

• dwContext
  [no] Valor de contexto para associar com o novo identificador Soquete.

• lpErrno
  [out] Ponteiro para o código de erro.

Return Value

Se não houver erro, essa função retorna o novo identificador Soquete. Caso contrário, ele retorna INVALID_SOCKET e um código de erro específico está disponível em lpErrno.

A seguinte tabela mostra a código de erro possíveis.

Valor de erro	Descrição
WSAENOBUFS	Não suficiente disponível buffers, muitos soquetes.

Remarks

Essa função cria um novo identificador Soquete para o provedor especificado. As alças criadas por essa função são indistinguíveis de sistema de arquivos True alças.

Considerações sobre do provedor de serviço em camadas

Uma em camadas provedor serviço pode usar esta função para criar as alças Soquete ele expõe para seu cliente.

Requirements

Header	ws2spi.h
Library	Ws2.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

WPUCloseSocketHandle
WPUQuerySocketHandleContext
WSPRecv
WSPSend
WSPStartup