IStreamBufferInitialize::SetSIDs

  • Artigo
 
Microsoft DirectShow 9.0

IStreamBufferInitialize::SetSIDs

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(
  DWORD  cSIDs,
  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 Values

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

Value 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: Include Sbe.h.

See Also