ISyncMgrSynchronizeCallback::EstablishConnection method

Called by the registered application's handler when a network connection is required.

Syntax


HRESULT EstablishConnection(
  [in] LPCWSTR pwszConnection,
  [in] DWORD   dwReserved
);

Parameters

pwszConnection [in]

Type: LPCWSTR

The name of the connection to dial.

dwReserved [in]

Type: DWORD

Return value

Type: HRESULT

This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

Return codeDescription
S_OK

The connection was successfully established.

 

Remarks

SyncMgr should use the default autodial connection if pwszConnection is NULL.

When an instance of EstablishConnection is called by a handler, SyncMgr tries to establish the connection. If a subsequent EstablishConnection is called then SyncMgr attempts the new connection without causing the previous connection to stop responding. All connections remain until all handlers have finished synchronizing. After all handlers have synchronized, then any opened connections are closed by SyncMgr.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mobsync.h

DLL

Mobsync.dll

See also

ISyncMgrSynchronizeCallback

 

 

Show: