Função PeerCollabGetContact (p2p.h)
A função PeerCollabGetContact obtém as informações de um contato par dado o nome do par do contato.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
[in, optional] PCWSTR pwzPeerName,
[out, optional] PPEER_CONTACT *ppContact
);
Parâmetros
[in, optional] pwzPeerName
Ponteiro para a cadeia de caracteres Unicode terminada em zero que contém o nome do contato par para o qual obter informações.
Se esse parâmetro for NULL, as informações de contato 'Eu' para o par de chamada serão retornadas.
[out, optional] ppContact
Ponteiro para um ponteiro para uma estrutura PEER_CONTACT . Ele recebe o endereço de uma estrutura PEER_CONTACT que contém informações de contato de pares para o nome do par fornecido em pwzPeerName. Quando esse parâmetro é NULL, essa função retorna E_INVALIDARG.
Chame PeerFreeData no endereço da estrutura PEER_CONTACT para liberar esses dados.
Retornar valor
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. |
|
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante. |
Requisitos
| Requisito | Valor |
|---|---|
| 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 |