Función CreatePrivateNamespaceA (winbase.h)

Crea un espacio de nombres privado.

Sintaxis

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

Parámetros

[in, optional] lpPrivateNamespaceAttributes

Puntero a una estructura SECURITY_ATTRIBUTES que especifica los atributos de seguridad del objeto de espacio de nombres.

[in] lpBoundaryDescriptor

Descriptor que define cómo se va a aislar el espacio de nombres. El autor de la llamada debe estar dentro de este límite. La función createBoundaryDescriptor crea un descriptor de límites.

[in] lpAliasPrefix

Prefijo del espacio de nombres. Para crear un objeto en este espacio de nombres, especifique el nombre del objeto como prefijo\objectname.

El sistema admite varios espacios de nombres privados con el mismo nombre, siempre que definan límites diferentes.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un identificador al nuevo espacio de nombres.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Otras aplicaciones pueden acceder al espacio de nombres mediante la función openPrivateNamespace .

La aplicación que creó el espacio de nombres puede usar la función ClosePrivateNamespace para cerrar el identificador del espacio de nombres. El identificador también se cierra cuando finaliza el proceso de creación. Una vez cerrado el identificador del espacio de nombres, las llamadas posteriores a OpenPrivateNamespace producen un error, pero todas las operaciones de los objetos del espacio de nombres se realizan correctamente.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o posterior.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	winbase.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

closePrivateNamespace

espacios de nombres de objeto

OpenPrivateNamespace