CreatePrivateNamespaceW, fonction (namespaceapi.h)

Crée un espace de noms privé.

Syntaxe

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

Paramètres

[in, optional] lpPrivateNamespaceAttributes

Pointeur vers une structure SECURITY_ATTRIBUTES qui spécifie les attributs de sécurité de l’objet d’espace de noms.

[in] lpBoundaryDescriptor

Descripteur qui définit la façon dont l’espace de noms doit être isolé. L’appelant doit se trouver dans cette limite. La fonction CreateBoundaryDescriptor crée un descripteur de limite.

[in] lpAliasPrefix

Préfixe de l’espace de noms. Pour créer un objet dans cet espace de noms, spécifiez le nom de l’objet comme préfixe\objectname.

Le système prend en charge plusieurs espaces de noms privés portant le même nom, à condition qu’ils définissent des limites différentes.

Valeur retournée

Si la fonction réussit, elle retourne un handle au nouvel espace de noms.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

D’autres applications peuvent accéder à l’espace de noms à l’aide de la fonction OpenPrivateNamespace .

L’application qui a créé l’espace de noms peut utiliser la fonction ClosePrivateNamespace pour fermer le handle à l’espace de noms. Le handle est également fermé lorsque le processus de création se termine. Une fois le handle d’espace de noms fermé, les appels suivants à OpenPrivateNamespace échouent, mais toutes les opérations sur les objets de l’espace de noms réussissent.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | UWP
Plateforme cible	Windows
En-tête	namespaceapi.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

ClosePrivateNamespace
Espaces de noms d’objets
OpenPrivateNamespace