PeerCollabSignout function (p2p.h)

The PeerCollabSignout function signs a peer out of a specific type of peer collaboration network presence provider.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignout(
  [in] DWORD dwSigninOptions
);

Parameters

[in] dwSigninOptions

PEER_SIGNIN_FLAGS enumeration value that contains the presence provider sign-in options for the calling peer. This value is obtained by calling PeerCollabGetSigninOptions from the peer application.

Return value

Returns S_OK if the function succeeds. Otherwise, the function returns one of the following values.

Return code Description
E_OUTOFMEMORY
There is not enough memory to support this operation.
E_INVALIDARG
One of the arguments is invalid.
PEER_E_NOT_INITIALIZED
The application did not make a previous call to PeerCollabStartup.

Remarks

If the local peer's collaboration infrastructure is signed out of both Internet and People Near Me presence, all transient information like objects and the endpoint ID are deleted. Any application that uses this information must republish the information. A single event that indicates signout is raised, instead of sending multiple individual events for each object or application.

Multiple applications can use the infrastructure at any given moment. It is not recommended for a single application to sign out, as other applications will not be able to use the infrastructure. Applications must also be prepared to handle user sign in and sign out, or situations where a machine goes to sleep or into hibernation.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header p2p.h
Library P2P.lib
DLL P2P.dll

See also

PEER_SIGNIN_FLAGS

Peer Collaboration API Functions

PeerCollabGetSigninOptions