Compartir a través de


Función PeerIdentityGetFriendlyName (p2p.h)

La función PeerIdentityGetFriendlyName devuelve el nombre descriptivo de la identidad del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

Parámetros

[in] pwzIdentity

Especifica la identidad del mismo nivel para obtener un nombre descriptivo.

[out] ppwzFriendlyName

Recibe un puntero al nombre descriptivo. Cuando ppwzFriendlyName ya no es necesario, la aplicación es responsable de liberar esta cadena llamando a PeerFreeData.

Valor devuelto

Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto Descripción
E_INVALIDARG
Uno de los parámetros no es válido.
E_OUTOFMEMORY
No hay suficiente memoria para realizar la operación especificada.
PEER_E_NO_KEY_ACCESS
Se deniega el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Normalmente, esto se debe a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se ha restablecido manualmente.
PEER_E_NOT_FOUND
No se encuentra una identidad del mismo nivel que coincida con el nombre especificado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack para Windows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h
Library P2P.lib
Archivo DLL P2P.dll

Consulte también

PeerFreeData

PeerIdentitySetFriendlyName