ILMNetProtocol::Connect

#include "netcon2.h"

C Syntax

HRESULT ILMNetProtocol_Connect(pProtocol, URL, ppCon, Timeout)

C++ Syntax

HRESULT Connect(URL, ppCon, Timeout)

 

ILMNetProtocol * pProtocol;

/* pointer to an interface */

LPCWSTR URL;

/* server address */

ILMNetConnection **ppCon;

/* pointer to an interface */

DWORD Timeout;

/* timeout */

Attempts a connection to a server.

Parameter

Description

pProtocol

Pointer to an ILMNetProtocol interface.

URL

A character string that contains the server address to which to connect.

ppCon

Pointer to a variable to be updated with a pointer to an ILMNetConnection interface.

Timeout

Value that represents the amount of time, in milliseconds, to wait for the connection process before failing.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function should not be used directly by the user; the ILMNetProtocolManager::Connect function calls this function.

Required DLLs and Libraries

LMNetCon
DSKernel

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Functions:

ILMNetProtocol::CreateConnectionPoint, ILMNetProtocolManager::Connect, ILMNetProtocolManager::CreateConnectionPoint, ILMNetConnection::Disconnect

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups

Example

For a C or C++ example, refer to How to Network (Client and Server) Using a User-Defined Protocol.