IStreamBufferInitialize::SetSIDs method (sbe.h)

  • Articolo

[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

See also

IStreamBufferInitialize Interface