CreatePrivateNamespaceA-Funktion (winbase.h)

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äfix\Objektnamean.

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

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Handle an den neuen Namespace zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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 mit dem Namespace zu schließen. Das Handle wird auch 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

Siehe auch

ClosePrivateNamespace-

Objektnamespaces

OpenPrivateNamespace-