Funzione PeerIdentityGetFriendlyName (p2p.h)

La funzione PeerIdentityGetFriendlyName restituisce il nome descrittivo dell'identità peer.

Sintassi

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

Parametri

[in] pwzIdentity

Specifica l'identità peer per ottenere un nome descrittivo.

[out] ppwzFriendlyName

Riceve un puntatore al nome descrittivo. Quando ppwzFriendlyName non è più necessario, l'applicazione è responsabile della liberazione di questa stringa chiamando PeerFreeData.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi peer identity o peer group viene negato. In genere, questo è causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL è stato reimpostato manualmente.
PEER_E_NOT_FOUND	Impossibile trovare un'identità peer corrispondente al nome specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack per Windows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PeerFreeData

PeerIdentitySetFriendlyName