Compartilhar via

Função PeerGroupIssueCredentials (p2p.h)

  • Artigo

A função PeerGroupIssueCredentials emite credenciais, incluindo um GMC, para uma identidade específica e, opcionalmente, retorna uma cadeia de caracteres XML de convite que o par convidado pode usar para ingressar em um grupo de pares.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

Parâmetros

[in] hGroup

Manipule para um grupo de pares para o qual um par emitirá credenciais para possíveis pares convidados. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pwzSubjectIdentity

Especifica a identidade de um par para o qual as credenciais serão emitidas. Este parâmetro é necessário.

[in] pCredentialInfo

PEER_CREDENTIAL_INFO estrutura que contém informações sobre as credenciais de um par cuja identidade é especificada em pwzSubjectIdentity. Se esse parâmetro for NULL, as informações armazenadas no banco de dados par serão usadas. Esse parâmetro é opcional.

Se esse parâmetro for fornecido, os seguintes campos no PEER_CREDENTIAL_INFO serão ignorados:

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

Especifica um conjunto de sinalizadores usados para descrever as ações executadas quando as credenciais são emitidas. Se esse parâmetro for definido como 0 (zero), as credenciais serão retornadas em ppwzInvitation. Esse parâmetro é opcional.

Valor Significado
PEER_GROUP_STORE_CREDENTIALS
 Publique o GMC recém-criado da identidade do assunto no banco de dados do grupo. O GMC é captado automaticamente pelo assunto. Se esse sinalizador não estiver definido, as credenciais deverão ser obtidas por um aplicativo diferente, como email.

[out] ppwzInvitation

Ponteiro para uma cadeia de caracteres XML de convite retornada pela chamada de função. Este convite é passado fora de banda para o par convidado que o usa em uma chamada para PeerGroupJoin. Esse parâmetro é opcional.

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 disponível para concluir a operação.
PEER_E_IDENTITY_DELETED
 A identidade que cria as credenciais foi excluída.
PEER_E_IDENTITY_NOT_FOUND
 A identidade não pode ser encontrada no banco de dados do grupo e pCredentialInfo é NULL.
PEER_E_NO_KEY_ACCESS
 O acesso às chaves de identidade ou grupo é 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 foi 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

Essa função só pode ser chamada com êxito por um administrador.

As credenciais de um membro (PEER_CREDENTIAL_INFO) são obtidas chamando PeerGroupEnumMembers. As credenciais estão localizadas no campo pCredentialInfo da estrutura PEER_MEMBER para um membro específico.

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