Função PeerGroupCreateInvitation (p2p.h)
A função PeerGroupCreateInvitation retorna uma cadeia de caracteres XML que pode ser usada pelo par especificado para ingressar em um grupo.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
[in] HGROUP hGroup,
[in] PCWSTR pwzIdentityInfo,
[in] FILETIME *pftExpiration,
[in] ULONG cRoles,
[in] const GUID *pRoles,
[out] PWSTR *ppwzInvitation
);
Parâmetros
[in] hGroup
Manipule para o grupo de pares para o qual este convite é emitido. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.
[in] pwzIdentityInfo
Ponteiro para uma cadeia de caracteres Unicode que contém o blob XML (incluindo o GMC) retornado por uma chamada anterior para PeerIdentityGetXML com a identidade do par. Como alternativa, esse parâmetro pode conter um ponteiro para um blob XML gerado por PeerIdentityGetXML usando as informações de par contidas em PEER_CONTACT para gerar um convite para um contato par.
[in] pftExpiration
Especifica uma estrutura UTC FILETIME que contém a data e a hora específicas em que o convite expira. Esse valor não pode ser maior que o tempo de vida restante do par emissor. Se esse parâmetro for NULL, o tempo de vida do convite será definido como o valor máximo possível – o tempo de vida restante do par.
[in] cRoles
Especifica a contagem de funções em pRoleInfo.
[in] pRoles
Ponteiro para uma lista de GUIDs que especifica o conjunto combinado de funções disponíveis. As funções disponíveis são as seguintes.
[out] ppwzInvitation
Ponteiro para uma cadeia de caracteres Unicode que contém o convite do emissor. Esse convite pode ser passado para PeerGroupJoin pelo destinatário para ingressar no grupo de pares especificado. Para retornar os detalhes do convite como uma estrutura PEER_INVITATION_INFO , passe essa cadeia de caracteres para PeerGroupParseInvitation. Para liberar esses dados, passe esse ponteiro para PeerFreeData.
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 a operação especificada. |
|
O grupo de pares não está em um estado em que os registros podem ser adicionados. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo não foi concluída. |
|
A cadeia GMC tem mais de 24 administradores ou membros. Para obter mais informações sobre cadeias GMC, consulte a documentação Como funciona a segurança do grupo . |
|
Os dados passados como pwzIdentityInfo são para uma identidade excluída e não são mais válidos. |
|
O par que chamou esse método não é um administrador. |
|
O acesso às chaves de identidade ou de grupo par é negado. Normalmente, isso é causado por uma ACL (lista de controle de acesso) incorreta para a pasta que contém as chaves do usuário ou do computador. Isso pode acontecer quando a ACL é redefinida manualmente. |
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
Os pares não podem criar convites para pares cujo papel assumido é superior ao seu próprio. Por exemplo, um par em uma função membro não pode criar um convite para um par em uma função de administrador.
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 |