IStreamBufferConfigure3::SetNamespace method (sbe.h)

[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 SetNamespace method specifies a prefix that is added to the names of the synchronization objects that the Stream Buffer Engine uses to synchronize the reader and writer.

Syntax

HRESULT SetNamespace(
  [in] LPWSTR pszNamespace
);

Parameters

[in] pszNamespace

Pointer to a null-terminated wide character string. If NULL, no prefix is used. Currently, the following values are supported.

  • L"Global"
  • NULL

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
CO_E_NOT_SUPPORTED
The specified prefix is not supported.

Remarks

The default value is "Global".

If the value is "Global", the synchronization objects are created in the global name space, which requires administrator privileges in Windows Vista or later. If the value is NULL, the synchronization objects are created in the local session name space, which does not require administrator privileges.

Requirements

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

See also

IStreamBufferConfigure3 Interface