Função PeerGroupCreatePasswordInvitation (p2p.h)

Artigo
03/01/2024

A função PeerGroupCreatePasswordInvitation retorna uma cadeia de caracteres XML que pode ser usada pelo par especificado para unir um grupo com uma senha correspondente.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [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.

[out] ppwzInvitation

Ponteiro para uma cadeia de caracteres Unicode que contém o convite do emissor. Esse convite pode ser passado para PeerGroupPasswordJoin 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.

Essa função requer que os campos a seguir sejam definidos na estrutura PEER_GROUP_PROPERTIES passada para PeerGroupCreate.

pwzGroupPassword. Esse campo deve conter a senha usada para validar pares que ingressam no grupo de pares.
groupPasswordRole. Esse campo deve conter o GUID da função (administrador ou par) para a qual a senha é necessária.
dwAuthenticationSchemes. Esse campo deve ter o sinalizador de PEER_GROUP_PASSWORD_AUTHENTICATION (0x00000001) definido nele.

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
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar a operação especificada.
PEER_E_GROUP_NOT_READY	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.
PEER_E_CHAIN_TOO_LONG	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 .
PEER_E_IDENTITY_DELETED	Os dados passados como pwzIdentityInfo são para uma identidade excluída e não são mais válidos.
PEER_E_NOT_AUTHORIZED	O par que chamou esse método não é um administrador.
PEER_E_NO_KEY_ACCESS	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.

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

Compartilhar via