CreatePrivateNamespaceW, fonction (namespaceapi.h)

Article
11/20/2024

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\nom d’objet.

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

Valeur de retour

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’erreur étendues, 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 de 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 en tant que 0x0600 ou version ultérieure.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau \| UWP
plateforme cible	Windows
d’en-tête	namespaceapi.h
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

ClosePrivateNamespace
espaces de noms d’objets
OpenPrivateNamespace

Partager via