Função PeerIdentityCreate (p2p.h)

A função PeerIdentityCreate cria uma nova identidade de par e retorna seu nome. O nome da identidade de par deve ser passado em todas as chamadas subsequentes para as funções Identity Manager par, Agrupamento de Pares ou PNRP que operam em nome da identidade de par. O nome da identidade do par especifica qual identidade de par está sendo usada.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityCreate(
  [in]  PCWSTR     pwzClassifier,
  [in]  PCWSTR     pwzFriendlyName,
  [in]  HCRYPTPROV hCryptProv,
  [out] PWSTR      *ppwzIdentity
);

Parâmetros

[in] pwzClassifier

Especifica o classificador a ser acrescentado ao nome de identidade de par publicado. Essa cadeia de caracteres é uma cadeia de caracteres Unicode e pode ser NULL. Essa cadeia de caracteres só pode ter 150 caracteres, incluindo o terminador NULL .

[in] pwzFriendlyName

Especifica o nome amigável da identidade do par. Essa é uma cadeia de caracteres Unicode e pode ser NULL. Essa cadeia de caracteres só pode ter 256 caracteres, incluindo o terminador NULL . Se pwzFriendlyName for NULL, o nome da identidade será o nome amigável. O nome amigável é opcional e não precisa ser exclusivo.

[in] hCryptProv

Identificador para o provedor de serviços criptográficos (CSP) que contém um par de chaves AT_KEYEXCHANGE de pelo menos 1024 bits de comprimento. Esse par de chaves é usado como base para uma nova identidade de par. Se hCryptProv for zero (0), um novo par de chaves será gerado para a identidade do par.

Nota A API Identity Manager não dá suporte a um CSP que tenha chaves protegidas pelo usuário. Se um CSP que tem chaves protegidas pelo usuário for usado, PeerIdentityCreate retornará E_INVALIDARG.

 

[out] ppwzIdentity

Recebe um ponteiro para o nome de uma identidade de par criada. Esse nome deve ser usado em todas as chamadas subsequentes para as funções Identity Manager Par, Agrupamento de Pares ou PNRP que operam em nome da identidade de par. Retornará NULL se a identidade de par não puder ser criada.

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno	Descrição
ERROR_INVALID_HANDLE	O identificador para a chave especificada por hCryptProv não é válido.
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_ALREADY_EXISTS	A identidade de par já existe. Só ocorrerá se já existir uma identidade de par com base na chave e no classificador especificados.
PEER_E_NO_KEY_ACCESS	O acesso à identidade de par ou às chaves do grupo de pares é 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.
PEER_E_TOO_MANY_IDENTITIES	A identidade de par não pode ser criada porque há muitas identidades de pares.

Comentários

O par de chaves e o classificador são usados para gerar o nome do par de uma nova identidade de par. Depois que uma identidade de par é criada, ela é armazenada automaticamente no disco.

O nome da identidade deve ser liberado usando PeerFreeData. Isso não exclui a identidade do par. Para excluir a identidade, use a função PeerIdentityDelete .

Se hCryptProv não for NULL, ele poderá ser liberado usando CryptReleaseContext após o retorno da chamada.

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 para Windows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll

Confira também

CryptReleaseContext

PeerFreeData

PeerIdentityDelete