ILMNetSrc::CheckConnection

#include "ILMNetSrc2.h"

C Syntax

HRESULT ILMNetSrc_CheckConnection(pNetSrc, URL, Flags, TimeOut)

C++ Syntax

HRESULT CheckConnection(URL, Flags, TimeOut)

 

ILMNetSrc *pNetSrc;

/* pointer to an interface */

BSTR URL;

/* server address */

long Flags;

/* flags */

long Timeout;

/* timeout */

Determines whether the server exists without making a connection.

Parameter

Description

 

pNetSrc

Pointer to an ILMNetSrc Interface.

URL

A character string that contains the server address which is to be checked.

Flags

Value that indicates whether the method should negotiate the user name and password. Possible values are:

 

Value

Meaning

 

0

Do not negotiate the user name and password.

 

NetSrc_CC_ForceConnection

Negotiate the user name and password.

Timeout

Value that represents the amount of time, in milliseconds, to wait for the 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.

Required DLLs and Libraries

LMNetSrc
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 A Complete Example: Server and Client.