IBitsPeer::GetPeerName method (bits3_0.h)

Gets the server principal name that uniquely identifies the peer.

Syntax

HRESULT GetPeerName(
  [out] LPWSTR *pName
);

Parameters

[out] pName

Null-terminated string that contains the server principal name of the peer. The principal name is of the form, server$.domain.suffix. Call the CoTaskMemFree function to free pName when done.

Return value

The method returns the following return values.

Return code Description
S_OK
Success

Remarks

The principal name ensures the unique identity of the peer computer and is the entity that Kerberos authenticates.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header bits3_0.h (include Bits.h)
Library Bits.lib

See also

IBitsPeer