ILMNetSnk::GetRestriction

#include "ILMNetSnk2.h"

C Syntax

HRESULT ILMNetSnk_getRestriction(pNetSnk, Index, pVal)

C++ Syntax

HRESULT GetRestriction(Index, pVal)

 

ILMNetSnk * pNetSnk;

/* pointer to an interface */

long Index;

/* restriction index */

BSTR *pVal;

/* pointer to a string */

Retrieves the restriction, IP address, at the specified index from the list of restrictions.

Parameter

Description

pNetSnk

Pointer to an ILMNetSnk interface.

Index

A zero-based index of the restriction IP address to retrieve from the list of restrictions.

pVal

Pointer to a character string to be updated with the restricted IP address at the specified index in the restriction list.

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

A restriction means that no connection is accepted from a specified IP address.

If the function succeeds, the user is responsible for freeing the retrieved IP address string by calling SysFreeString.

Required DLLs and Libraries

LMNetSnk
DSKernel
LMNetCon

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:

ILMNetSnk::FindRestriction, ILMNetSnk::RemoveRestriction,

Topics:

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

Example

For a C example, refer to The Server Side Example for C.

For a C++ example, refer to The Server Side Example for C++.