Функция CreatePrivateNamespaceA (winbase.h)

Статья
11/20/2024

Создает частное пространство имен.

Синтаксис

HANDLE CreatePrivateNamespaceA(
  [in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
  [in]           LPVOID                lpBoundaryDescriptor,
  [in]           LPCSTR                lpAliasPrefix
);

Параметры

[in, optional] lpPrivateNamespaceAttributes

Указатель на структуру SECURITY_ATTRIBUTES, указывающую атрибуты безопасности объекта пространства имен.

[in] lpBoundaryDescriptor

Дескриптор, определяющий способ изоляции пространства имен. Вызывающий объект должен находиться в пределах этой границы. Функция createBoundaryDescriptor создает дескриптор границ.

[in] lpAliasPrefix

Префикс пространства имен. Чтобы создать объект в этом пространстве имен, укажите имя объекта как префикс \имя объекта.

Система поддерживает несколько частных пространств имен с одинаковым именем, если они определяют разные границы.

Возвращаемое значение

Если функция завершается успешно, она возвращает дескриптор в новое пространство имен.

Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Другие приложения могут получить доступ к пространству имен с помощью функции OpenPrivateNamespace.

Приложение, создающее пространство имен, может использовать функцию ClosePrivateNamespace для закрытия дескриптора к пространству имен. Дескриптор также закрывается при завершении процесса создания. После закрытия дескриптора пространства имен последующие вызовы OpenPrivateNamespace сбоем, но все операции с объектами в пространстве имен завершаются успешно.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2008 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

ClosePrivateNamespace

пространства имен объектов

OpenPrivateNamespace

Поделиться через