Compartilhar via


Função PeerIdentityGetCryptKey (p2p.h)

A função PeerIdentityGetCryptKey recupera um identificador para um CSP (provedor de serviços criptográficos).

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetCryptKey(
  [in]  PCWSTR     pwzIdentity,
  [out] HCRYPTPROV *phCryptProv
);

Parâmetros

[in] pwzIdentity

Especifica a identidade de par para a qual recuperar o par de chaves.

[out] phCryptProv

Recebe um ponteiro para o identificador do CSP (provedor de serviços criptográficos) que contém um par de chaves RSA AT_KEYEXCHANGE.

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
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_NO_KEY_ACCESS
O acesso à identidade de par ou às chaves de 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_NOT_FOUND
Uma identidade que corresponde ao nome especificado não pode ser encontrada.

Comentários

A chave pode ser recuperada chamando CryptGetUserKey.

Quando o identificador não é mais necessário, o aplicativo é responsável por liberar o identificador usando CryptReleaseContext.

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

Cryptgetuserkey

CryptReleaseContext