Função PeerIdentityGetFriendlyName (p2p.h)
A função PeerIdentityGetFriendlyName retorna o nome amigável da identidade de par.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
[in] PCWSTR pwzIdentity,
[out] PWSTR *ppwzFriendlyName
);
Parâmetros
[in] pwzIdentity
Especifica a identidade de par para obter um nome amigável.
[out] ppwzFriendlyName
Recebe um ponteiro para o nome amigável. Quando ppwzFriendlyName não é mais necessário, o aplicativo é responsável por liberar essa cadeia de caracteres chamando PeerFreeData.
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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar a operação especificada. |
|
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. |
|
Uma identidade de par que corresponde ao nome especificado não pode ser encontrada. |
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 |