IStreamBufferInitialize::SetSIDs method (sbe.h)

Article
12/05/2018

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The SetSIDs method sets the security identifiers (SIDs) that are used to protect access to the backing files.

Syntax

HRESULT SetSIDs(
  [in] DWORD cSIDs,
  [in] PSID  *ppSID
);

Parameters

[in] cSIDs

Specifies the size of the array given in the ppSID parameter.

[in] ppSID

Pointer to an array of SID structures, of size cSIDs.

Return value

Returns an HRESULT. Possible values include those in the following table.

Return code	Description
E_INVALIDARG	Invalid argument.
E_POINTER	Null pointer argument.
S_OK	The method succeeded.

Remarks

At run time, the Stream Buffer Source and Sink filters create various Win32 objects, such as mutexes, so that access to the backing files is synchronized across threads. Each of the filters maintains a list of SIDs that are used to protect these objects. By default, the filters inherit their SIDs from the hosting process. An application can use the SetSIDs method to override the default SIDs.

If you call this method, do so before locking the sink filter or loading a file in the source filter. It is recommended that all of the filters be given the same SIDs.

Important��Setting less-privileged SIDs can create a security issue.

�

Note that this method does not apply to content recording files, which are protected by the discretionary access-control lists (DACLs) of the directory structure.

Requirements

Requirement	Value
Minimum supported client	Windows�XP with SP1 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	sbe.h

Share via