Função PeerCreatePeerName (p2p.h)
A função PeerCreatePeerName cria um novo nome com base no nome existente da identidade e do classificador de pares especificados. No entanto, uma nova identidade não é criada por uma chamada para PeerCreatePeerName.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzClassifier,
[out] PWSTR *ppwzPeerName
);
Parâmetros
[in] pwzIdentity
Especifica a identidade a ser usada como base para o novo nome de par. Se pwzIdentity for NULL, o nome criado não será baseado em nenhuma identidade de par e, portanto, será um nome não seguro.
Esse parâmetro só poderá ser NULL se pwzClassifier não for NULL.
[in] pwzClassifier
Ponteiro para a cadeia de caracteres Unicode que contém o novo classificador. Esse classificador é acrescentado à parte de autoridade existente do nome do par da identidade especificada. Essa cadeia de caracteres tem 150 caracteres, incluindo o terminador NULL . Especifique NULL para retornar o nome do par da identidade.
Esse parâmetro só poderá ser NULL se pwzIdentity não for NULL.
[out] ppwzPeerName
Ponteiro que recebe um ponteiro para o novo nome de par. Quando essa cadeia de caracteres não for mais necessária, libere-a chamando PeerFreeData.
Retornar valor
Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar a operação especificada. |
Comentários
O parâmetro ppwzPeername deve ser definido como nulo antes que a função PeerCreatePeerName seja chamada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado para Windows XP |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |