IStreamBufferInitialize::SetSIDs Method

Article
01/07/2009

This topic applies only to Windows XP Service Pack 1 or later.
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

cSIDs [in]
Specifies the size of the array given in the ppSID parameter.
ppSID [in]
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

Header

Declared in Sbe.h.

Share via