CreatePrivateNamespaceA, fonction (winbase.h)
Crée un espace de noms privé.
Syntaxe
HANDLE CreatePrivateNamespaceA(
[in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
[in] LPVOID lpBoundaryDescriptor,
[in] LPCSTR 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
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |