Funzione PeerIdentityGetFriendlyName (p2p.h)

Articolo
03/01/2024

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

Condividi tramite