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 de 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ímite.

[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 y cuando definan límites diferentes.

Valor devuelto

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

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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

Vea también

ClosePrivateNamespace

Espacios de nombres de objeto

OpenPrivateNamespace