ILMNetProtocolManager::Connect

#include "netcon2.h"

C Syntax

HRESULT ILMNetProtocolManager_Connect(pProtMngr, URL, ppCon, Timeout)

C++ Syntax

HRESULT Connect(URL, ppCon, Timeout)

 

ILMNetProtocolManager * pProtMngr;

/* pointer to an interface */

LPCWSTR URL;

/* string */

ILMNetConnection **ppCon;

/* pointer to an interface */

DWORD Timeout;

/* timeout */

Attempts a connection to a server.

Parameter

Description

pProtMngr

Pointer to an ILMNetProtocolManager 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. This function calls the ILMNetProtocol::Connect 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.

See Also

Functions:

ILMNetProtocolManager::RegisterProtocol, ILMNetProtocolManager::UnregisterProtocol, ILMNetProtocolManager::CreateConnectionPoint

Topics:

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

Example

For examples, refer to How to Create a User-Defined Protocol and How to Network (Client and Server) Using a User-Defined Protocol.