Función PeerCreatePeerName (p2p.h)

La función PeerCreatePeerName crea un nuevo nombre basado en el nombre existente de la identidad y clasificador del mismo nivel especificados. Sin embargo, una llamada a PeerCreatePeerName no crea una nueva identidad.

Sintaxis

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

Parámetros

[in] pwzIdentity

Especifica la identidad que se va a usar como base para el nuevo nombre del mismo nivel. Si pwzIdentity es NULL, el nombre creado no se basa en ninguna identidad del mismo nivel y, por tanto, es un nombre no seguro.

Este parámetro solo puede ser NULL si pwzClassifier no es NULL.

[in] pwzClassifier

Puntero a la cadena Unicode que contiene el nuevo clasificador. Este clasificador se anexa a la parte de autoridad existente del nombre del mismo nivel de la identidad especificada. Esta cadena tiene 150 caracteres, incluido el terminador NULL . Especifique NULL para devolver el nombre del mismo nivel de la identidad.

Este parámetro solo puede ser NULL si pwzIdentity no es NULL.

[out] ppwzPeerName

Puntero que recibe un puntero al nuevo nombre del mismo nivel. Cuando esta cadena ya no sea necesaria, ábrela 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.

Comentarios

El parámetro ppwzPeername debe establecerse en null antes de llamar a la función PeerCreatePeerName .

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