Função PeerGroupGetRecord (p2p.h)
A função PeerGroupGetRecord recupera um registro de grupo específico.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
[in] HGROUP hGroup,
[in] const GUID *pRecordId,
[out] PPEER_RECORD *ppRecord
);
Parâmetros
[in] hGroup
Manipule para um grupo que contém um registro específico. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.
[in] pRecordId
Especifica o valor guid que identifica exclusivamente um registro necessário em um grupo de pares. Este parâmetro é necessário.
[out] ppRecord
Ponteiro para o endereço de uma estrutura PEER_RECORD que contém um registro retornado. Essa estrutura é liberada passando seu ponteiro para PeerFreeData. Este parâmetro é necessário.
Valor retornado
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 a operação especificada. |
|
O grupo de pares não está em um estado em que os registros de grupo podem ser recuperados. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo par não foi concluída. |
|
O identificador para um grupo de pares é inválido. |
|
Um registro que corresponde à ID fornecida não pode ser encontrado em um banco de dados de grupo par. |
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.
Requisitos
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 |