IStreamBufferConfigure3::SetNamespace Method

Article
01/07/2009

This topic applies to Windows Vista or later.
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

pszNamespace [in]
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

Header

Declared in Sbe.h.

Share via