Funzione PeerCreatePeerName (p2p.h)

La funzione PeerCreatePeerName crea un nuovo nome in base al nome esistente dell'identità peer e del classificatore specificati. Tuttavia, una nuova identità non viene creata da una chiamata a PeerCreatePeerName.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Parametri

[in] pwzIdentity

Specifica l'identità da usare come base per il nuovo nome peer. Se pwzIdentity è NULL, il nome creato non è basato su alcuna identità peer ed è quindi un nome non protetto.

Questo parametro può essere NULL solo se pwzClassifier non è NULL.

[in] pwzClassifier

Puntatore alla stringa Unicode che contiene il nuovo classificatore. Questo classificatore viene aggiunto alla parte dell'autorità esistente del nome peer dell'identità specificata. Questa stringa è lunga 150 caratteri, incluso il carattere di terminazione NULL . Specificare NULL per restituire il nome peer dell'identità.

Questo parametro può essere NULL solo se pwzIdentity non è NULL.

[out] ppwzPeerName

Puntatore che riceve un puntatore al nuovo nome peer. Quando questa stringa non è più necessaria, liberarla chiamando PeerFreeData.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene 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.

Commenti

Il parametro ppwzPeername deve essere impostato su null prima che venga chiamata la funzione PeerCreatePeerName .

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