Função PeerIdentitySetFriendlyName (p2p.h)
A função PeerIdentitySetFriendlyName modifica o nome amigável de uma identidade de par especificada. O nome amigável é o nome legível por humanos.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzFriendlyName
);
Parâmetros
[in] pwzIdentity
Especifica uma identidade de par a ser modificada.
[in] pwzFriendlyName
Especifica um novo nome amigável. Especifique NULL ou uma cadeia de caracteres vazia para redefinir um nome amigável para o valor padrão, que é a versão Unicode do nome do par.
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 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. |
|
Uma identidade de par que corresponda a um 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 |