In This Topic ▼

IltmmRTSPServer::put_Security

Summary

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

Syntax

#include "ltmm.h"

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

Parameters

IltmmRTSPServer *pThis

Pointer to the IltmmRTSPServer interface.

long index

0-based index of the source folder whose security settings should be set.Use -1 to set the default RTSP Server security settings.

IUnknown *newValue

The ILMRTSPSecurity interface containing the security settings. If NULL, no authentication is required to access the folder (or server).

Returns

Value	Meaning
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 an RTSP client connects. It will not affect RTSP clients already connected.