Função PeerGroupGetProperties (p2p.h)
A função PeerGroupGetProperties recupera informações sobre as propriedades de um grupo especificado.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
[in] HGROUP hGroup,
[out] PPEER_GROUP_PROPERTIES *ppProperties
);
Parâmetros
[in] hGroup
Manipule para um grupo de pares cujas propriedades são recuperadas. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.
[out] ppProperties
Ponteiro para uma estrutura PEER_GROUP_PROPERTIES que contém informações sobre as propriedades do grupo de pares. Esses dados devem ser liberados com PeerFreeData. 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. |
|
Não há memória suficiente para executar uma operação especificada. |
|
O grupo não está em um estado em que as propriedades do grupo de pares podem ser recuperadas. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo não foi concluída. |
|
O identificador para o grupo de pares é inválido. |
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
As propriedades de grupo não poderão ser recuperadas se um par não tiver sido sincronizado com um banco de dados de grupo par. Para sincronizar com um banco de dados de grupo par antes de chamar essa função, primeiro chame PeerGroupConnect.
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 |