Função PeerCollabAddContact (p2p.h)
A função PeerCollabAddContact adiciona um contato à lista de contatos de um par.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
Parâmetros
[in] pwzContactData
Ponteiro para um buffer de cadeia de caracteres Unicode com terminação zero que contém os dados de contato do par que é adicionado à lista de contatos. Esse buffer de cadeia de caracteres pode ser obtido passando o nome do par do ponto de extremidade para adicionar como um contato a PeerCollabQueryContactData ou por meio de um mecanismo fora de banda.
Para enviar seus próprios dados de contato fora de banda, o par pode chamar PeerCollabExportContact com um nome de par NULL . Essa função retorna os dados de contato no formato XML.
[out, optional] ppContact
Ponteiro para um ponteiro para uma estrutura PEER_CONTACT . Esse parâmetro recebe o endereço de uma estrutura de PEER_CONTACT que contém informações de contato par para o contato fornecido em pwzContactData. Esse parâmetro pode ser NULL.
Chame PeerFreeData no endereço da estrutura PEER_CONTACT para liberar esses dados.
Valor retornado
Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Não há memória suficiente para dar suporte a essa operação. |
|
Um dos argumentos é inválido. |
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |