Função PeerGroupSendData (p2p.h)
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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
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 |