CreatePrivateNamespaceW 函数 (namespaceapi.h)

创建专用命名空间。

语法

HANDLE CreatePrivateNamespaceW(
  [in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
  [in]           LPVOID                lpBoundaryDescriptor,
  [in]           LPCWSTR               lpAliasPrefix
);

参数

[in, optional] lpPrivateNamespaceAttributes

指向 SECURITY_ATTRIBUTES 结构的指针,该结构指定命名空间对象的安全属性。

[in] lpBoundaryDescriptor

一个描述符,用于定义命名空间的隔离方式。 调用方必须在此边界内。 CreateBoundaryDescriptor 函数创建边界描述符。

[in] lpAliasPrefix

命名空间的前缀。 若要在此命名空间中创建对象,请将对象名称指定为 前缀\objectname

只要这些命名空间定义了不同的边界,系统就支持具有相同名称的多个专用命名空间。

返回值

如果函数成功,它将返回新命名空间的句柄。

如果函数失败,则返回值 NULL。 若要获取扩展的错误信息,请调用 GetLastError

言论

其他应用程序可以使用 OpenPrivateNamespace 函数访问命名空间。

创建命名空间的应用程序可以使用 ClosePrivateNamespace 函数关闭命名空间的句柄。 创建进程终止时,句柄也会关闭。 关闭命名空间句柄后,后续调用 OpenPrivateNamespace 失败,但命名空间中对象的所有操作都成功。

若要编译使用此函数的应用程序,请将 _WIN32_WINNT 定义为0x0600或更高版本。

要求

要求 价值
最低支持的客户端 Windows Vista [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2008 [桌面应用 |UWP
目标平台 窗户
标头 namespaceapi.h
Kernel32.lib
DLL Kernel32.dll

另请参阅

ClosePrivateNamespace
对象命名空间
OpenPrivateNamespace