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

Статья
03/08/2023

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

Синтаксис

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

Параметры

[in, optional] lpPrivateNamespaceAttributes

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

[in] lpBoundaryDescriptor

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

[in] lpAliasPrefix

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

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

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

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

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

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

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

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

ClosePrivateNamespace

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

OpenPrivateNamespace

Share via