Função PeerGroupSendData (p2p.h)

Artigo
03/05/2024

A função PeerGroupSendData envia dados a um membro por meio de uma conexão direta ou vizinha.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSendData(
  [in] HGROUP     hGroup,
  [in] ULONGLONG  ullConnectionId,
  [in] const GUID *pType,
  [in] ULONG      cbData,
  [in] PVOID      pvData
);

Parâmetros

[in] hGroup

Manipule para o grupo que contém os dois membros de uma conexão. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] ullConnectionId

Inteiro de 64 bits sem sinal que contém a ID da conexão que hospeda a transmissão de dados. Uma ID de conexão é obtida chamando PeerGroupOpenDirectConnection. Este parâmetro é necessário.

[in] pType

Ponteiro para um valor guid que identifica exclusivamente os dados que estão sendo transmitidos. Este parâmetro é necessário.

[in] cbData

Especifica o tamanho dos dados em pvData, em bytes. Este parâmetro é necessário.

[in] pvData

Ponteiro para o bloco de dados a ser enviado. O aplicativo de recebimento é responsável por analisar esses dados. Este parâmetro é necessário.

Retornar valor

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
PEER_E_CONNECTION_NOT_FOUND	Uma conexão com a ID especificada em ullConnectionId não pode ser encontrada.

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Comentários

Para receber dados, o par receptor deve ter se registrado para o PEER_GROUP_EVENT_INCOMING_DATA evento par.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll