Compartilhar via


Função PeerCollabExportContact (p2p.h)

A função PeerCollabExportContact exporta os dados de contato associados a um nome de par para um buffer de cadeia de caracteres. O buffer contém dados de contato no formato XML.

A função PeerCollabAddContact permite que essa cadeia de caracteres XML seja utilizada por outros pares.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

Parâmetros

[in, optional] pwzPeerName

Ponteiro para cadeia de caracteres Unicode terminada em zero que contém o nome do contato par para o qual exportar.

Se esse parâmetro for NULL, as informações de contato "Eu" para o par de chamada serão exportadas.

[out, optional] ppwzContactData

Ponteiro para um buffer de cadeia de caracteres com terminação zero que contém dados XML de contato par em que os nomes de pares correspondem à cadeia de caracteres fornecida em pwzPeerName.

A memória retornada aqui pode ser liberada chamando PeerFreeData.

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
E_OUTOFMEMORY
Não há memória suficiente para dar suporte a essa operação.
E_INVALIDARG
Um dos argumentos é inválido.
PEER_E_NOT_INITIALIZED
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante.
PEER_E_NOT_SIGNED_IN
Um dos argumentos é inválido.

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

Confira também

Funções da API de Colaboração de Pares