CreatePrivateNamespaceA-Funktion (winbase.h)

  • Artikel

Erstellt einen privaten Namespace.

Syntax

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

Parameter

[in, optional] lpPrivateNamespaceAttributes

Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die die Sicherheitsattribute des Namespaceobjekts angibt.

[in] lpBoundaryDescriptor

Ein Deskriptor, der definiert, wie der Namespace isoliert werden soll. Der Aufrufer muss innerhalb dieser Grenze sein. Die CreateBoundaryDescriptor-Funktion erstellt einen Begrenzungsdeskriptor.

[in] lpAliasPrefix

Das Präfix für den Namespace. Um ein Objekt in diesem Namespace zu erstellen, geben Sie den Objektnamen als Präfixobjektname\ an.

Das System unterstützt mehrere private Namespaces mit demselben Namen, sofern sie unterschiedliche Grenzen definieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ein Handle an den neuen Namespace zurück.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Andere Anwendungen können mithilfe der OpenPrivateNamespace-Funktion auf den Namespace zugreifen.

Die Anwendung, die den Namespace erstellt hat, kann die ClosePrivateNamespace-Funktion verwenden, um das Handle für den Namespace zu schließen. Das Handle wird ebenfalls geschlossen, wenn der Erstellungsprozess beendet wird. Nachdem das Namespacehandle geschlossen wurde, schlagen nachfolgende Aufrufe von OpenPrivateNamespace fehl, aber alle Vorgänge für Objekte im Namespace sind erfolgreich.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

ClosePrivateNamespace

Objektnamespaces

OpenPrivateNamespace