Collapse All Expand All

IltmmRTSPServer::put_Security

#include "ltmm.h"

C Syntax	HRESULT IltmmRTSPServer_put_Security(pThis, index, newValue)
C++ Syntax	HRESULT put_Security(index, newValue)

 

IltmmRTSPServer *pThis;	/* pointer to the interface */
long index;	/* source index */
IUnknown *newValue;	/* the security settings interface */

Sets the security settings for a source folder or the whole server.

Parameter	Description
pThis	Pointer to the IltmmRTSPServer interface.
index	0-based index of the source folder whose security settings should be set. Use -1 to set the default RTSP Server security settings.
newValue	The ILMRTSPSecurity Interface containing the security settings. If NULL, no authentication is required to access the folder (or server).

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

If index is between 0 and SourceCount - 1  (where SourceCount is the number of folders in the list, as indicated by IltmmRTSPServer::get_SourceCount), this function sets the security settings for the source with the index equal to index.

If index is set to -1, this function sets the default security settings for the RTSP server. All the current folders are set to these security settings. Also, all future folders added with IltmmRTSPServer::put_SourceFolder will use the default security settings.

If you never set the security settings for the RTSP server, the default security setting is NULL (no authentication is used).

See the ILMRTSPSecurity Interface documentation for more information on RTSP security settings (also called 'authentication').

If the server is running, the updated security settings will be used the next time a RTSP client connects. It will not affect RTSP clients already connected.

Required DLLs and Libraries

LTMM 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

Elements:	IltmmRTSPServer interface, IltmmRTSPServer::get_Security, IltmmRTSPServer::put_SourceFolder, ILMRTSPSecurity Interface
Topics:	Multimedia Function Groups Use IltmmRTPServer to implement a RTSP Server

Example

For a C++ example, refer to IltmmRTSPServer Example for C++.