Função PeerCollabEnumApplications (p2p.h)
A função PeerCollabEnumApplications retorna o identificador para uma enumeração que contém os aplicativos registrados nos pontos de extremidade de um par específico.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in, optional] pcEndpoint
Ponteiro para uma estrutura PEER_ENDPOINT que contém as informações do ponto de extremidade para um par cujos aplicativos serão enumerados.
Se esse parâmetro for definido como NULL, as informações do aplicativo publicado para o ponto de extremidade do par local serão enumeradas.
[in, optional] pApplicationId
Ponteiro para o valor guid que identifica exclusivamente um aplicativo específico do par fornecido. Se esse parâmetro for fornecido, o único aplicativo par retornado será aquele que corresponde a esse GUID.
[out] phPeerEnum
Ponteiro para o identificador do conjunto enumerado de aplicativos registrados que correspondem ao GUID retornado em pObjectId. Passe esse identificador para PeerGetNextItem para obter cada item no conjunto enumerado.
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. |
|
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante. |
Comentários
Para enumerar os aplicativos para o ponto de extremidade especificado com êxito, os dados do aplicativo devem estar disponíveis no ponto de extremidade. Para que os dados do aplicativo estejam disponíveis, um dos seguintes deve ocorrer:
- O ponto de extremidade deve ter sido obtido anteriormente chamando PeerCollabEnumEndpoints.
- O par local deve ter se inscrito no ponto de extremidade chamando PeerCollabSubscribeEndpointData.
- Os dados do ponto de extremidade devem ser atualizados chamando PeerCollabRefreshEndpointData com êxito.
Para obter os aplicativos pares individuais, passe o identificador retornado para PeerGetNextItem. Para fechar a enumeração e liberar os recursos associados a ela, passe esse identificador para PeerEndEnumeration. Itens individuais retornados pela enumeração devem ser liberados com PeerFreeData.
Os itens de dados de aplicativo par são retornados como estruturas de PEER_APPLICATION individuais.
A função PeerCollabEnumApplications retorna uma matriz vazia para pontos de extremidade na sub-rede que não são contatos confiáveis.
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 |